CONVINFO  X.EQ9Z 

The CONVINFO structure contains information about a DDE conversation.

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;

    HWND        hwnd;

    HWND        hwndPartner;

} CONVINFO;

 

Members

cb

Specifies the structure s size, in bytes.

hUser

Identifies application-defined data.

hConvPartner

Identifies the partner application in the DDE conversation. This member is zero if the partner has not registered itself (using the DdeInitialize1_PFUXK function) to make DDE Management Library (DDEML) function calls. An application should not pass this member to any DDEML function except DdeQueryConvInfo14336H1.

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; it 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 a server to send updated data to the client during an advise loop. This transaction results when the server calls DdePostAdvise157GWJY.

XTYP_ADVSTART

Requests a server to begin an advise loop with a client.

XTYP_ADVSTOP

Notifies a server that an advise loop is stopping.

XTYP_CONNECT

Requests a server to 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_EXECUTE

Requests a server to execute a command sent by a client.

XTYP_MONITOR

Notifies an application registered as APPCMD_MONITOR that DDE data is being transmitted.

XTYP_POKE

Requests a server to accept unsolicited data from a client.

XTYP_REGISTER

Notifies other DDEML applications that a server has registered a service name.

XTYP_REQUEST

Requests a server to send data to a client.

XTYP_UNREGISTER

Notifies other DDEML applications that a server has unregistered a service name.

XTYP_WILDCONNECT

Requests a server to establish multiple conversations with the same client.

XTYP_XACT_COMPLETE

Notifies a client that an asynchronous data transaction has been completed.

 

wStatus

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

Value

Meaning

ST_ADVISE

One or more links are in progress.

ST_BLOCKED

The conversation is blocked.

ST_BLOCKNEXT

The conversation will block after calling the next callback.

ST_CLIENT

The conversation handle passed to the DdeQueryConvInfo14336H1 function is a client-side handle. If the handle is zero, the conversation handle passed to the DdeQueryConvInfo function is a server-side handle.

ST_CONNECTED

The conversation is connected.

ST_INLIST

The conversation is a member of a conversation list.

ST_ISLOCAL

Both sides of the conversation are using the DDEML.

ST_ISSELF

Both sides of the conversation are using the same instance of the DDEML.

ST_TERMINATED

The conversation has been terminated by the partner.

 

wConvst

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

Value

Meaning

XST_ADVACKRCVD

The advise transaction has just been completed.

XST_ADVDATAACKRCVD

The advise data transaction has just been completed.

XST_ADVDATASENT

Advise data has been sent and is awaiting an acknowledgement.

XST_ADVSENT

An advise transaction is awaiting an acknowledgement.

XST_CONNECTED

The conversation has no active transactions.

XST_DATARCVD

The requested data has just been received.

XST_EXECACKRCVD

An execute transaction has just been completed.

XST_EXECSENT

An execute transaction is awaiting an acknowledgement.

XST_INCOMPLETE

The last transaction failed.

XST_INIT1

Mid-initiate state 1.

XST_INIT2

Mid-initiate state 2.

XST_NULL

Pre-initiate state.

XST_POKEACKRCVD

A poke transaction has just been completed.

XST_POKESENT

A poke transaction is awaiting an acknowledgement.

XST_REQSENT

A request transaction is awaiting an acknowledgement.

XST_UNADVACKRCVD

An unadvise transaction has just been completed.

XST_UNADVSENT

An unadvise transaction is awaiting an acknowledgement.

 

wLastError

Specifies the error value associated with the last transaction.

hConvList

Identifies the conversation list if the handle of the current conversation is in a conversation list. This member is NULL if the conversation is not in a conversation list.

ConvCtxt

Specifies the conversation context.

hwnd

Identifies the window of the calling application involved in the conversation.

hwndPartner

Identifies the window of the partner application involved in the current conversation.

 

See Also

CONVCONTEXT, DdeInitialize, DdePostAdvise, DdeQueryConvInfo