XTYP_CONNECT

A DDE server callback function receives this transaction when a client specifies an service name that the server supports, and a non-NULL topic name, in a call to the DdeConnect function.

Parameters

wFmt

Not used.

hConv

Not used.

hsz1

Identifies the topic name.

hsz2

Identifies the service name.

hData

Not used.

dwData1

Points to a CONCONTEXT 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 the same instance. If 0, the client is a different instance.

Return Value

A server callback function should return TRUE to allow the client to establish a conversation on the specified service/topic pair, or FALSE to deny the conversation. If the callback function returns TRUE and a conversation is successfully established, the system passes the conversation handle to the server by issuing an XTYP_CONNECT_CONFIRM transaction to the server's callback function (unless the server specified the CBF_FAIL_CONNECT_CONFIRMS flag in the DdeInitialize function).

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.

See Also

DdeConnect, DdeInitialize