XTYP_ADVDATA

3.1

#include <ddeml.h>

XTYP_ADVDATA
hszTopic = hsz1;     /* handle of topic-name string */
hszItem = hsz2;      /* handle of item-name string  */
hDataAdvise = hData; /* handle of the advise data   */

A client's DDE callback function can receive this transaction after the client has established an advise loop with a server. This transaction informs the client that the value of the data item has changed.

Parameters

hszTopic

Value of hsz1. Identifies the topic name.

hszItem

Value of hsz2. Identifies the item name.

hDataAdvise

Value of hData. Identifies the data associated with the topic/item name pair. If the client specified the XTYPF_NODATA flag when it requested the advise loop, this parameter is NULL.

Return Value

A DDE callback function should return DDE_FACK if it processes this transaction, DDE_FBUSY if it is too busy to process this transaction, or DDE_FNOTPROCESSED if it denies this transaction.

Comments

An application need not free the data handle obtained during this transaction. If the application needs to process the data after the callback function returns, however, it must copy the data associated with the data handle. An application can use the DdeGetData function to copy the data.

See Also

DdeClientTransaction, DdePostAdvise