DdeSetUserHandle-Funktion (ddeml.h)

Artikel
03/01/2024

Ordnet einen anwendungsdefinierten Wert einem Konversationshandle oder einem Transaktionsbezeichner zu. Dies ist nützlich, um die Verarbeitung asynchroner Transaktionen zu vereinfachen. Eine Anwendung kann die DdeQueryConvInfo-Funktion verwenden, um diesen Wert abzurufen.

Syntax

BOOL DdeSetUserHandle(
  [in] HCONV     hConv,
  [in] DWORD     id,
  [in] DWORD_PTR hUser
);

Parameter

[in] hConv

Typ: HCONV

Ein Handle für die Unterhaltung.

[in] id

Art: DWORD

Der Transaktionsbezeichner, der dem vom hUser-Parameter angegebenen Wert zugeordnet werden soll. Eine Anwendung sollte diesen Parameter auf QID_SYNC festlegen, um hUser der durch den hConv-Parameter identifizierten Konversation zuzuordnen.

[in] hUser

Typ: DWORD_PTR

Der Wert, der dem Konversationshandle zugeordnet werden soll.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

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

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

Siehe auch

Konzept

DdeQueryConvInfo

Verwaltungsbibliothek für dynamische Daten

Referenz

Freigeben über