CONVINFO

3.1 

#include <ddeml.h>

typedef struct tagCONVINFO { /* ci */
    DWORD   cb;
    DWORD   hUser;
    HCONV   hConvPartner;
    HSZ     hszSvcPartner;
    HSZ     hszServiceReq;
    HSZ     hszTopic;
    HSZ     hszItem;
    UINT    wFmt;
    UINT    wType;
    UINT    wStatus;
    UINT    wConvst;
    UINT    wLastError;
    HCONVLIST hConvList;
    CONVCONTEXT ConvCtxt;
} CONVINFO;

The CONVINFO structure contains information about a dynamic data exchange (DDE) conversation.

Members

cb

Specifies the length of the structure, in bytes.

hUser

Identifies application-defined data.

hConvPartner

Identifies the partner application in the DDE conversation. If the partner has not registered itself (by using the DdeInitialize function) to make DDE Management Library (DDEML) function calls, this member is set to 0. An application should not pass this member to any DDEML function except DdeQueryConvInfo.

hszSvcPartner

Identifies the service name of the partner application.

hszServiceReq

Identifies the service name of the server application that was requested for connection.

hszTopic

Identifies the name of the requested topic.

hszItem

Identifies the name of the requested item. This member is transaction-specific.

wFmt

Specifies the format of the data being exchanged. This member is transaction-specific.

wType

Specifies the type of the current transaction. This member is transaction-specific and can be one of the following values:

Value Meaning

XTYP_ADVDATA Informs a client that advise data from a server has arrived.
XTYP_ADVREQ Requests that a server send updated data to the client during an advise loop. This transaction results when the server calls the DdePostAdvise function.
XTYP_ADVSTART Requests that a server begin an advise loop with a client.
XTYP_ADVSTOP Notifies a server that an advise loop is ending.
XTYP_CONNECT Requests that a server establish a conversation with a client.
XTYP_CONNECT_CONFIRM Notifies a server that a conversation with a client has been established.
XTYP_DISCONNECT Notifies a server that a conversation has terminated.
XTYP_ERROR Notifies a DDEML application that a critical error has occurred. The DDEML may have insufficient resources to continue.
XTYP_EXECUTE Requests that a server execute a command sent by a client.
XTYP_MONITOR Notifies an application registered as APPCMD_MONITOR of DDE data being transmitted.
XTYP_POKE Requests that a server accept unsolicited data from a client.
XTYP_REGISTER Notifies other DDEML applications that a server has registered a service name.
XTYP_REQUEST Requests that a server send data to a client.
XTYP_UNREGISTER Notifies other DDEML applications that a server has unregistered a service name.
XTYP_WILDCONNECT Requests that a server establish multiple conversations with the same client.
XTYP_XACT_COMPLETE Notifies a client that an asynchronous data transaction has completed.

wStatus

Specifies the status of the current conversation. This member can be a combination of the following values:

ST_ADVISE ST_BLOCKED ST_BLOCKNEXT ST_CLIENT ST_CONNECTED ST_INLIST ST_ISLOCAL ST_ISSELF ST_TERMINATED

wConvst

Specifies the conversation state. This member can be one of the following values:

XST_ADVACKRCVD XST_ADVDATAACKRCVD XST_ADVDATASENT XST_ADVSENT XST_CONNECTED XST_DATARCVD XST_EXECACKRCVD XST_EXECSENT XST_INCOMPLETE XST_INIT1 XST_INIT2 XST_NULL XST_POKEACKRCVD XST_POKESENT XST_REQSENT XST_UNADVACKRCVD XST_UNADVSENT

wLastError

Specifies the error value associated with the last transaction.

hConvList

If the handle of the current conversation is in a conversation list, identifies the conversation list. Otherwise, this member is NULL.

ConvCtxt

Specifies the conversation context.

See Also

CONVCONTEXT