CONVINFO structure (ddeml.h)
Contains information about a Dynamic Data Exchange (DDE) conversation.
Syntax
typedef struct tagCONVINFO {
DWORD cb;
DWORD_PTR 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, *PCONVINFO;
Members
cb
Type: DWORD
The structure's size, in bytes.
hUser
Type: DWORD_PTR
Application-defined data.
hConvPartner
Type: HCONV
A handle to the partner application in the DDE conversation. This member is zero if the partner has not registered itself (using the DdeInitialize function) to make DDEML function calls. An application should not pass this member to any DDEML function except DdeQueryConvInfo.
hszSvcPartner
Type: HSZ
A handle to the service name of the partner application.
hszServiceReq
Type: HSZ
A handle to the service name of the server application that was requested for connection.
hszTopic
Type: HSZ
A handle to the name of the requested topic.
hszItem
Type: HSZ
A handle to the name of the requested item. This member is transaction specific.
wFmt
Type: UINT
The format of the data being exchanged. This member is transaction specific.
wType
Type: UINT
The type of the current transaction. This member is transaction specific; it can be one of the following values.
Value | Meaning |
---|---|
|
Informs a client that advise data from a server has arrived. |
|
Requests a server to send updated data to the client during an advise loop. This transaction results when the server calls DdePostAdvise. |
|
Requests a server to begin an advise loop with a client. |
|
Notifies a server that an advise loop is stopping. |
|
Requests a server to establish a conversation with a client. |
|
Notifies a server that a conversation with a client has been established. |
|
Notifies a server that a conversation has terminated. |
|
Requests a server to execute a command sent by a client. |
|
Notifies an application registered as APPCMD_MONITOR that DDE data is being transmitted. |
|
Requests a server to accept unsolicited data from a client. |
|
Notifies other DDEML applications that a server has registered a service name. |
|
Requests a server to send data to a client. |
|
Notifies other DDEML applications that a server has unregistered a service name. |
|
Requests a server to establish multiple conversations with the same client. |
|
Notifies a client that an asynchronous data transaction has been completed. |
wStatus
Type: UINT
The status of the current conversation. This member can be one or more of the following values.
Value | Meaning |
---|---|
|
One or more links are in progress. |
|
The conversation is blocked. |
|
The conversation will block after calling the next callback. |
|
The con0x0010versation handle passed to the DdeQueryConvInfo function is a client-side handle. If the handle is zero, the conversation handle passed to the DdeQueryConvInfo function is a server-side handle. |
|
The conversation is connected. |
|
The conversation is a member of a conversation list. |
|
Both sides of the conversation are using the DDEML. |
|
Both sides of the conversation are using the same instance of the DDEML. |
|
The conversation has been terminated by the partner. |
wConvst
Type: UINT
The conversation state. This member can be one of the following values.
wLastError
Type: UINT
The error value associated with the last transaction.
hConvList
Type: HCONVLIST
A handle to the conversation list if the handle to the current conversation is in a conversation list. This member is NULL if the conversation is not in a conversation list.
ConvCtxt
Type: CONVCONTEXT
The conversation context.
hwnd
Type: HWND
A handle to the window of the calling application involved in the conversation.
hwndPartner
Type: HWND
A handle to the window of the partner application involved in the current conversation.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header | ddeml.h (include Windows.h) |
See also
Conceptual
Dynamic Data Exchange Management Library
Reference