XTYP_ADVSTART

3.1

#include <ddeml.h>

XTYP_ADVSTART
hszTopic = hsz1;     /* handle of topic-name string */
hszItem = hsz2;      /* handle of item-name string  */

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

Parameters

hszTopic

Value of hsz1. Identifies the topic name.

hszItem

Value of hsz2. Identifies the item name.

Return Value

To allow an advise loop on the specified topic/item name pair, a server's DDE callback function should return a nonzero value. To deny the advise loop, it should return zero. If the callback function returns a nonzero value, any subsequent call by the server to the DdePostAdvise function on the same topic/item name pair will cause the system to send a XTYP_ADVREQ transaction to the server.

Comments

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

If the server application specified the CBF_FAIL_ADVISES flag in the DdeInitialize function, this transaction is filtered.

See Also

DdeClientTransaction, DdeInitialize, DdePostAdvise