Freigeben über


CONVINFO-Struktur (ddeml.h)

Enthält Informationen zu einer DDE-Unterhaltung (Dynamic Data Exchange).

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;

Member

cb

Art: DWORD

Die Größe der Struktur in Bytes.

hUser

Typ: DWORD_PTR

Anwendungsdefinierte Daten.

hConvPartner

Typ: HCONV

Ein Handle für die Partneranwendung in der DDE-Unterhaltung. Dieser Member ist 0, wenn sich der Partner nicht selbst registriert hat (mithilfe der DdeInitialize-Funktion ), um DDEML-Funktionsaufrufe auszuführen. Eine Anwendung sollte diesen Member nicht an eine DDEML-Funktion mit Ausnahme von DdeQueryConvInfo übergeben.

hszSvcPartner

Typ: HSZ

Ein Handle für den Dienstnamen der Partneranwendung.

hszServiceReq

Typ: HSZ

Ein Handle für den Dienstnamen der Serveranwendung, die für die Verbindung angefordert wurde.

hszTopic

Typ: HSZ

Ein Handle für den Namen des angeforderten Themas.

hszItem

Typ: HSZ

Ein Handle für den Namen des angeforderten Elements. Dieses Element ist transaktionsspezifisch.

wFmt

Typ: UINT

Das Format der ausgetauschten Daten. Dieses Element ist transaktionsspezifisch.

wType

Typ: UINT

Der Typ der aktuellen Transaktion. Dieses Element ist transaktionsspezifisch. Es kann sich um einen der folgenden Werte handeln.

Wert Bedeutung
XTYP_ADVDATA
0x4010
Informiert einen Client, der daten von einem Server eintrifft.
XTYP_ADVREQ
0x2022
Fordert einen Server an, während einer Empfehlungsschleife aktualisierte Daten an den Client zu senden. Diese Transaktion ergibt sich, wenn der Server DdePostAdvise aufruft.
XTYP_ADVSTART
0x1030
Fordert einen Server auf, eine Empfehlungsschleife mit einem Client zu starten.
XTYP_ADVSTOP
0x8040
Benachrichtigt einen Server, dass eine Empfehlungsschleife beendet wird.
XTYP_CONNECT
0x1062
Fordert einen Server an, eine Konversation mit einem Client herzustellen.
XTYP_CONNECT_CONFIRM
0x8072
Benachrichtigt einen Server, dass eine Unterhaltung mit einem Client eingerichtet wurde.
XTYP_DISCONNECT
0x80C2
Benachrichtigt einen Server, dass eine Unterhaltung beendet wurde.
XTYP_EXECUTE
0x4050
Fordert einen Server an, einen befehl auszuführen, der von einem Client gesendet wurde.
XTYP_MONITOR
0x80F2
Benachrichtigt eine Anwendung, die als APPCMD_MONITOR registriert ist, dass DDE-Daten übertragen werden.
XTYP_POKE
0x4090
Fordert einen Server an, nicht angeforderte Daten von einem Client zu akzeptieren.
XTYP_REGISTER
0x80A2
Benachrichtigt andere DDEML-Anwendungen, dass ein Server einen Dienstnamen registriert hat.
XTYP_REQUEST
0x20B0
Fordert einen Server an, Daten an einen Client zu senden.
XTYP_UNREGISTER
0x80D2
Benachrichtigt andere DDEML-Anwendungen, dass ein Server die Registrierung eines Dienstnamens aufgehoben hat.
XTYP_WILDCONNECT
0x20E2
Fordert einen Server an, mehrere Unterhaltungen mit demselben Client einzurichten.
XTYP_XACT_COMPLETE
0x8080
Benachrichtigt einen Client, dass eine asynchrone Datentransaktion abgeschlossen wurde.

wStatus

Typ: UINT

Die status der aktuellen Unterhaltung. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
ST_ADVISE
0x0002
Mindestens ein Link wird ausgeführt.
ST_BLOCKED
0x0008
Die Unterhaltung ist blockiert.
ST_BLOCKNEXT
0x0080
Die Unterhaltung wird nach dem Aufrufen des nächsten Rückrufs blockiert.
ST_CLIENT
0x0010
Das con0x0010versation-Handle, das an die DdeQueryConvInfo-Funktion übergeben wird, ist ein clientseitiges Handle. Wenn das Handle 0 ist, ist das an die DdeQueryConvInfo-Funktion übergebene Konversationshandle ein serverseitiges Handle.
ST_CONNECTED
0x0001
Die Unterhaltung ist verbunden.
ST_INLIST
0x0040
Die Unterhaltung ist Mitglied einer Unterhaltungsliste.
ST_ISLOCAL
0x0004
Beide Seiten der Unterhaltung verwenden die DDEML.
ST_ISSELF
0x0100
Beide Seiten der Unterhaltung verwenden dieselbe instance der DDEML.
ST_TERMINATED
0x0020
Die Unterhaltung wurde vom Partner beendet.

wConvst

Typ: UINT

Der Konversationszustand. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
XST_ADVACKRCVD
13
Die Beratungstransaktion wurde gerade abgeschlossen.
XST_ADVDATAACKRCVD
16
Die Transaktion mit den Beratungsdaten wurde gerade abgeschlossen.
XST_ADVDATASENT
15
Empfehlungsdaten wurden gesendet und warten auf eine Bestätigung.
XST_ADVSENT
11
Eine Beratungstransaktion wartet auf eine Bestätigung.
XST_CONNECTED
2
Die Unterhaltung verfügt über keine aktiven Transaktionen.
XST_DATARCVD
6
Die angeforderten Daten wurden gerade empfangen.
XST_EXECACKRCVD
10
Eine Ausführungstransaktion wurde gerade abgeschlossen.
XST_EXECSENT
9
Eine Ausführungstransaktion wartet auf eine Bestätigung.
XST_INCOMPLETE
1
Fehler bei der letzten Transaktion.
XST_INIT1
3
Mid-initiate state 1.
XST_INIT2
4
Mittlerer Initiierter Zustand 2.
XST_NULL
0
Zustand vor dem Initiieren.
XST_POKEACKRCVD
8
Eine Poke-Transaktion wurde gerade abgeschlossen.
XST_POKESENT
7
Eine Poke-Transaktion wartet auf eine Bestätigung.
XST_REQSENT
5
Eine Anforderungstransaktion wartet auf eine Bestätigung.
XST_UNADVACKRCVD
14
Eine nicht zu überwachende Transaktion wurde gerade abgeschlossen.
XST_UNADVSENT
12
Eine nicht autorisierte Transaktion wartet auf eine Bestätigung.

wLastError

Typ: UINT

Der Fehlerwert, der der letzten Transaktion zugeordnet ist.

hConvList

Typ: HCONVLIST

Ein Handle für die Unterhaltungsliste, wenn sich das Handle für die aktuelle Unterhaltung in einer Unterhaltungsliste befindet. Dieser Member ist NULL , wenn die Unterhaltung nicht in einer Unterhaltungsliste enthalten ist.

ConvCtxt

Typ: CONVCONTEXT

Der Konversationskontext.

hwnd

Typ: HWND

Ein Handle für das Fenster der aufrufenden Anwendung, die an der Unterhaltung beteiligt ist.

hwndPartner

Typ: HWND

Ein Handle für das Fenster der Partneranwendung, die an der aktuellen Unterhaltung beteiligt ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile ddeml.h (Windows.h einschließen)

Weitere Informationen

CONVCONTEXT

Konzept

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

Dynamic Data Exchange Management Library

Referenz