XTYP_REQUEST transaction
A client uses the XTYP_REQUEST transaction to request data from a server. A Dynamic Data Exchange (DDE) server callback function, DdeCallback, receives this transaction when a client specifies XTYP_REQUEST in the DdeClientTransaction function.
#define XCLASS_DATA 0x2000
#define XTYP_REQUEST (0x00B0 | XCLASS_DATA )
Parameters
-
uType
-
The transaction type.
-
uFmt
-
The format in which the server should submit data to the client.
-
hconv
-
A handle to the conversation.
-
hsz1
-
A handle to the topic name.
-
hsz2
-
A handle to the item name.
-
hdata
-
Not used.
-
dwData1
-
Not used.
-
dwData2
-
Not used.
Return value
The server should call the DdeCreateDataHandle function to create a data handle that identifies the data and then return the handle. The server should return NULL if it is unable to complete the transaction. If the server returns NULL, the client will receive a DDE_FNOTPROCESSED flag.
Remarks
This transaction is filtered if the server application specified the CBF_FAIL_REQUESTS flag in the DdeInitialize function.
If responding to this transaction requires lengthy processing, the server can return the CBR_BLOCK return code to suspend future transactions on the current conversation and then process the transaction asynchronously. When the server has finished and the data is ready to pass to the client, the server can call the DdeEnableCallback function to resume the conversation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|