XTYP_ADVREQ
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