Funzione DdeFreeDataHandle (ddeml.h)

Articolo
02/29/2024

Libera un oggetto DDE (Dynamic Data Exchange) ed elimina l'handle di dati associato all'oggetto .

Sintassi

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Parametri

[in] hData

Tipo: HDDEDATA

Handle per l'oggetto DDE da liberare. Questo handle deve essere stato creato da una chiamata precedente alla funzione DdeCreateDataHandle o restituita dalla funzione DdeClientTransaction .

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

La funzione DdeGetLastError può essere usata per ottenere il codice di errore, che può essere uno dei valori seguenti:

Commenti

Un'applicazione deve chiamare DdeFreeDataHandle nelle circostanze seguenti:

Per liberare un oggetto DDE allocato dall'applicazione chiamando la funzione DdeCreateDataHandle se l'handle dati dell'oggetto non è mai stato passato dall'applicazione a un'altra funzione DDEML (Dynamic Data Exchange Management Library)
Per liberare un oggetto DDE allocato dall'applicazione specificando il flag HDATA_APPOWNED in una chiamata a DdeCreateDataHandle
Per liberare un oggetto DDE la cui gestione dell'applicazione ricevuta dalla funzione DdeClientTransaction

Il sistema libera automaticamente un oggetto non generato quando il relativo handle viene restituito da una funzione di callback DDE o viene usato come parametro in una funzione DDEML.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ddeml.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll