Home   Index   About
Ultimate Pack


Custom Search
Overview
Group
Quick Info

Windows NT
Yes
Win95
Yes
Win32s
Yes
Import Library
-
Header File
ddeml.h
Unicode
No
Platform Notes
None

CONVINFO

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 DdeInitialize function) to make DDE Management Library (DDEML) function calls. 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; 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 DdePostAdvise.
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 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.
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


Last news from Greatis Software

Nostalgia .Net     Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes.  More »

Recommended software for developers

Ultimate Pack for Delphi and C++ Builder     Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price.  More »

Form Designer .Net     Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro!  More »

Print Suite .Net     Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available  More »

Gradient Controls .Net     Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available  More »

iGrid     Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors.  More »


All the contacts and projects

Dmitry Vasiliev (just.dmitry)

Related Links

Software for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008-2011 Free Tech Secrets ;) greatis just4fun network just4fun