Fonction DdeFreeDataHandle (ddeml.h)

Article
02/26/2024

Libère un objet DDE (Dynamic Data Exchange) et supprime le handle de données associé à l’objet.

Syntaxe

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Paramètres

[in] hData

Type : HDDEDATA

Handle de l’objet DDE à libérer. Ce handle doit avoir été créé par un appel précédent à la fonction DdeCreateDataHandle ou retourné par la fonction DdeClientTransaction .

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 :

Remarques

Une application doit appeler DdeFreeDataHandle dans les circonstances suivantes :

Pour libérer un objet DDE alloué par l’application en appelant la fonction DdeCreateDataHandle si le handle de données de l’objet n’a jamais été passé par l’application à une autre fonction DDEML (Dynamic Data Exchange Management Library)
Pour libérer un objet DDE alloué par l’application en spécifiant l’indicateur HDATA_APPOWNED dans un appel à DdeCreateDataHandle
Pour libérer un objet DDE dont le handle l’application a reçu de la fonction DdeClientTransaction

Le système libère automatiquement un objet non propriétaire lorsque son handle est retourné par une fonction de rappel DDE ou est utilisé comme paramètre dans une fonction DDEML.

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