DdeSetUserHandle, fonction (ddeml.h)

Associe une valeur définie par l’application à un handle de conversation ou à un identificateur de transaction. Cela est utile pour simplifier le traitement des transactions asynchrones. Une application peut utiliser la fonction DdeQueryConvInfo pour récupérer cette valeur.

Syntaxe

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

Paramètres

[in] hConv

Type : HCONV

Handle de la conversation.

[in] id

Type : DWORD

Identificateur de transaction à associer à la valeur spécifiée par le paramètre hUser . Une application doit définir ce paramètre sur QID_SYNC pour associer hUser à la conversation identifiée par le paramètre hConv .

[in] hUser

Type : DWORD_PTR

Valeur à associer au handle de conversation.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

La fonction DdeGetLastError peut être utilisée pour obtenir le code d’erreur, qui peut être l’une des valeurs suivantes :

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ddeml.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll

Voir aussi

Conceptuel

DdeQueryConvInfo

Bibliothèque de gestion Dynamic Data Exchange

Référence