The system sends this 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/item pair and that data corresponding to the topic/item pair has changed.
wFmt
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/format 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 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 in not used.
dwData2
Not used.
The server should call the DdeCreateDataHandle function to create a data handle that identifies the changed data, then return the handle. The server should return NULL if it is unable to complete the transaction.
A server cannot block this transaction type; the CBR_BLOCK return code is ignored.
DdeCreateDataHandle, DdeInitialize, DdePostAdvise