XTYP_ADVREQ
The system sends the XTYP_ADVREQ transaction to a server after the server calls the DdePostAdvise function. This transaction informs the server that an advise transaction is outstanding on the specified topic name and item name pair and that data corresponding to the topic name and item name pair has changed.
Parameters
uFmt
Specifies the format in which the data should be submitted to the client.
hconv
Identifies the conversation.
hsz1
Identifies the topic name.
hsz2
Identifies the item name that has changed.
hdata
Not used.
dwData1
Specifies the count, in the low-order word, of XTYP_ADVREQ transactions that remain to be processed on the same topic, item, and format name set within the context of the current call to the DdePostAdvise function. The count is zero if the current XTYP_ADVREQ transaction is the last one. A server can use this count to determine whether to create an HDATA_APPOWNED data handle for the advise data.
The low-order word is set to CADV_LATEACK if the Dynamic Data Exchange Management Library (DDEML) issued the XTYP_ADVREQ transaction because of a late-arriving DDE_ACK message from a client being outrun by the server.
The high-order word is not used.
dwData2
Not used.
Return Values
The server should first call the DdeCreateDataHandle function to create a data handle that identifies the changed data and then return the handle. The server should return NULL if it is unable to complete the transaction.
Remarks
A server cannot block this transaction type; the CBR_BLOCK return code is ignored.
See Also