Condividi tramite

Funzione DdeFreeDataHandle (ddeml.h)

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

Vedi anche

Informazioni concettuali

DdeAccessData

Ddeclienttransaction

DdeCreateDataHandle

Libreria di gestione di Dynamic Data Exchange

Riferimento

  • Last updated on