DdeQueryConvInfo-Funktion (ddeml.h)

Artikel
02/29/2024

Ruft Informationen zu einer DDE-Transaktion (Dynamic Data Exchange) und zu der Konversation ab, in der die Transaktion stattfindet.

Syntax

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Parameter

[in] hConv

Typ: HCONV

Ein Handle für die Unterhaltung.

[in] idTransaction

Art: DWORD

Die Transaktion. Bei asynchronen Transaktionen sollte es sich bei diesem Parameter um einen Transaktionsbezeichner handeln, der von der DdeClientTransaction-Funktion zurückgegeben wird. Bei synchronen Transaktionen sollte dieser Parameter QID_SYNC werden.

[in, out] pConvInfo

Typ: PCONVINFO

Ein Zeiger auf die CONVINFO-Struktur , die Informationen zur Transaktion und Unterhaltung empfängt. Das cb-Element der CONVINFO-Struktur muss die Länge des Puffers angeben, der der Struktur zugewiesen ist.

Rückgabewert

Typ: UINT

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Bytes, die in die CONVINFO-Struktur kopiert wurden.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

Die DdeGetLastError-Funktion kann verwendet werden, um den Fehlercode abzurufen, der einer der folgenden Werte sein kann:

Hinweise

Eine Anwendung sollte kein Zeichenfolgenhandle freigeben, auf das von der CONVINFO-Struktur verwiesen wird. Wenn eine Anwendung eines dieser Zeichenfolgenhandles verwenden muss, sollte sie die DdeKeepStringHandle-Funktion aufrufen, um eine Kopie des Handles zu erstellen.

Wenn der idTransaction-Parameter auf QID_SYNC festgelegt ist, ist das hUser-Element der CONVINFO-Struktur der Konversation zugeordnet und kann verwendet werden, um daten aufzunehmen, die der Unterhaltung zugeordnet sind. Wenn idTransaction der Bezeichner einer asynchronen Transaktion ist, wird der hUser-Member nur der aktuellen Transaktion zugeordnet und ist nur für die Dauer der Transaktion gültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ddeml.h (Einschließen von Windows.h)
Bibliothek	User32.lib
DLL	User32.dll