CONVINFO-Struktur (ddeml.h)

Artikel
08/23/2023

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)