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 |
|---|---|
|
Informiert einen Client, der daten von einem Server eintrifft. |
|
Fordert einen Server an, während einer Empfehlungsschleife aktualisierte Daten an den Client zu senden. Diese Transaktion ergibt sich, wenn der Server DdePostAdvise aufruft. |
|
Fordert einen Server auf, eine Empfehlungsschleife mit einem Client zu starten. |
|
Benachrichtigt einen Server, dass eine Empfehlungsschleife beendet wird. |
|
Fordert einen Server an, eine Konversation mit einem Client herzustellen. |
|
Benachrichtigt einen Server, dass eine Unterhaltung mit einem Client eingerichtet wurde. |
|
Benachrichtigt einen Server, dass eine Unterhaltung beendet wurde. |
|
Fordert einen Server an, einen befehl auszuführen, der von einem Client gesendet wurde. |
|
Benachrichtigt eine Anwendung, die als APPCMD_MONITOR registriert ist, dass DDE-Daten übertragen werden. |
|
Fordert einen Server an, nicht angeforderte Daten von einem Client zu akzeptieren. |
|
Benachrichtigt andere DDEML-Anwendungen, dass ein Server einen Dienstnamen registriert hat. |
|
Fordert einen Server an, Daten an einen Client zu senden. |
|
Benachrichtigt andere DDEML-Anwendungen, dass ein Server die Registrierung eines Dienstnamens aufgehoben hat. |
|
Fordert einen Server an, mehrere Unterhaltungen mit demselben Client einzurichten. |
|
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 |
|---|---|
|
Mindestens ein Link wird ausgeführt. |
|
Die Unterhaltung ist blockiert. |
|
Die Unterhaltung wird nach dem Aufrufen des nächsten Rückrufs blockiert. |
|
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. |
|
Die Unterhaltung ist verbunden. |
|
Die Unterhaltung ist Mitglied einer Unterhaltungsliste. |
|
Beide Seiten der Unterhaltung verwenden die DDEML. |
|
Beide Seiten der Unterhaltung verwenden dieselbe instance der DDEML. |
|
Die Unterhaltung wurde vom Partner beendet. |
wConvst
Typ: UINT
Der Konversationszustand. Dieser Member kann einer der folgenden Werte sein.
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
Konzept
Dynamic Data Exchange Management Library
Referenz