XTYP_ADVDATA transaction
Informs the client that the value of the data item has changed. The Dynamic Data Exchange (DDE) client callback function, DdeCallback, receives this transaction after establishing an advise loop with a server.
#define XCLASS_FLAGS 0x4000
#define XTYP_ADVDATA (0x0010 | XCLASS_FLAGS )
Parameters
-
uType
-
The transaction type.
-
uFmt
-
The format atom of the data sent from the server.
-
hconv
-
A handle to the conversation.
-
hsz1
-
A handle to the topic name.
-
hsz2
-
A handle to the item name.
-
hdata
-
A handle to the data associated with the topic name and item name pair. This parameter is NULL if the client specified the XTYPF_NODATA flag when it requested the advise loop.
-
dwData1
-
Not used.
-
dwData2
-
Not used.
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 rejects this transaction.
Remarks
An application must not free the data handle obtained during this transaction. An application must, however, copy the data associated with the data handle if the application must process the data after the callback function returns. An application can use the DdeGetData function to copy the data.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|
See also
-
Reference
-
Conceptual