XTYP_WILDCONNECT

3.1

#include <ddeml.h>

XTYP_WILDCONNECT
hszTopic = hsz1;                  /* handle of topic-name string      */
hszService = hsz2;                /* handle of service-name string    */
pcc = (CONVCONTEXT FAR *)dwData1; /* address of CONVCONTEXT structure */
fSameInst = (BOOL) dwData2;       /* same-instance flag               */

A server's DDE callback function receives this transaction when a client specifies a service name that is set to NULL, a topic name that is set to NULL, or both in a call to the DdeConnect function. This transaction allows a client to establish a conversation on each of the server's service/topic name pairs that matches the specified service name and topic name.

Parameters

hszTopic

Value of hsz1. Identifies the topic name. If this parameter is NULL, the client is requesting a conversation on all topic names that the server supports.

hszService

Value of hsz2. Identifies the service name. If this parameter is NULL, the client is requesting a conversation on all service names that the server supports.

pcc

Value of dwData1. Points to a CONVCONTEXT data structure that contains context information for the conversation. If the client is not a DDEML application, this parameter is set to zero.

fSameInst

Value of dwData2. Specifies whether the client is the same application instance as the server. If this parameter is TRUE, the client is same instance. If this parameter is FALSE, the client is a different instance.

Return Value

The server should return a data handle that identifies an array of HSZPAIR structures. The array should contain one structure for each service/topic name pair that matches the service/topic name pair requested by the client. The array must be terminated by a NULL string handle. The system sends the XTYP_CONNECT_CONFIRM transaction to the server to confirm each conversation and to pass the conversation handles to the server. If the server specified the CBF_SKIP_CONNECT_CONFIRMS flag in the DdeInitialize function, it cannot receive these confirmations.

To refuse the XTYP_WILDCONNECT transaction, the server should return NULL.

Comments

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

A server cannot block this transaction type; the CBR_BLOCK return code is ignored.