XTYP_WILDCONNECT

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

Parameters

wFmt

Not used.

hConv

Not used.

hsz1

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

hsz2

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

hData

Not used.

dwData1

Points to a CONVCONTEXT data structure that contains context information for the conversation. If the client is a non-DDEML application, this parameter is set to 0.

dwData2

Specifies whether the client is the same application instance as the server. If 1, the client is same instance. If 0, 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 pair that matches the service/topic 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. The server will not receive these confirmations if it specified the CBF_SKIP_CONNECT_CONFIRMS flag in the DdeInitialize function.

The server should return NULL to refuse the XTYP_WILDCONNECT transaction.

Comments

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

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