XTYP_ADVSTART

A DDE server callback function receives this transaction when a client specifies XTYP_ADVSTART as the wType parameter of the DdeClientTransaction function. A client uses this transaction to establish an advise loop with a server.

Parameters

wFmt

Specifies the data format requested by the client.

hConv

Identifies the conversation.

hsz1

Identifies the topic name.

hsz2

Identifies the item name.

hData

Not used.

dwData1

Not used.

dwData2

Not used.

Return Value

A server callback function should return TRUE to allow an advise loop on the specified topic/item pair, or FALSE to prevent the advise loop. If the callback function returns TRUE, any subsequent calls to the DdePostAdvise function by the server on the same topic/item pair will cause the system to send XTYP_ADVREQ transactions to the server.

Comments

If a client requests an advise loop on a topic/item/format set for which an advise loop is already established, the DDEML will not create a duplicate advise loop but will instead alter the advise loop flags (XTYPF_ACKREQ and XTYPF_NODATA) to match the latest request.

This transaction is filtered if the server application specified the CBF_FAIL_ADVISES flag in the DdeInitialize function.

See Also

DdeClientTransaction, DdeInitialize, DdePostAdvise,