WinDdePostMsg - Parameters

hwndTo (HWND) - input

Window handle of target.

hwndFrom (HWND) - input

Window handle of originator.

usMsgId (ULONG) - input

Message identifier.

Identifies the message to be posted.

The following messages are valid:

WM_DDE_ACK WM_DDE_ADVISE
WM_DDE_DATA
WM_DDE_EXECUTE
WM_DDE_POKE
WM_DDE_REQUEST
WM_DDE_TERMINATE
WM_DDE_UNADVISE.

pData (PDDESTRUCT) - input

Pointer to the DDE control structure being passed.

ulOptions (ULONG) - input

Options.

It must be one of the following values:

DDEPM_RETRY

This controls what happens if the message cannot be posted because the destination queue is full.

If this option is set, then message posting is retried at 1-second intervals, until the message is posted successfully. In this case, this function dispatches any messages in the queue of the application issuing this function, by calling the WinPeekMsg and WinDispatchMsg functions in a loop, so that messages sent by other applications can be received. This means that the application can continue to receive DDE messages (or other kinds of messages), while attempting to post DDE messages, thereby preventing deadlock between two applications whose queues are full and who are both attempting to post a message to each other with this option set.

Applications which rely on inspecting messages prior to issuing the WinPeekMsg function can either, use the WinSetHook function and detect the above situation in the invoked hook procedure by testing the MSGF_DDEPOSTMSG value of the msgf parameter, or not use this option, in order to avoid the deadlock situation.

If this option is not set, then this function returns FALSE without retrying.

Note: If the message posting fails for any other reason (for example, an invalid window handle is specified), this function returns FALSE even if this option has been selected.

DDEPM_NOFREE
This option prevents the WinDdePostMsg call from freeing the shared memory block passed in on the pData parameter. If this option is used, the caller is responsible for freeing the memory block at some subsequent time (for example, the same memory block could be used in multiple calls to WinDdePostMsg and then freed once at the end of those calls.

If this option is not specified, the DDE structure will be freed.

rc (BOOL) - returns

Success indicator.

TRUE

Successful completion
FALSE
Error occurred.

---

[Back: WinDdePostMsg Return Value - rc]
[Next: WinDdePostMsg - Remarks]