Freigeben über


DdeFreeDataHandle-Funktion (ddeml.h)

Gibt ein DDE-Objekt (Dynamic Data Exchange) frei und löscht das dem Objekt zugeordnete Datenhandle.

Syntax

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Parameter

[in] hData

Typ: HDDEDATA

Ein Handle für das zu freigebende DDE-Objekt. Dieses Handle muss durch einen vorherigen Aufruf der DdeCreateDataHandle-Funktion erstellt oder von der DdeClientTransaction-Funktion zurückgegeben worden sein.

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:

Hinweise

Eine Anwendung muss DdeFreeDataHandle unter den folgenden Umständen aufrufen:

  • So geben Sie ein DDE-Objekt frei, das die Anwendung zugewiesen hat, indem Sie die DdeCreateDataHandle-Funktion aufrufen, wenn das Datenhandle des Objekts nie von der Anwendung an eine andere DDEML-Funktion (Dynamic Data Exchange Management Library) übergeben wurde
  • So geben Sie ein von der Anwendung zugewiesenes DDE-Objekt frei, indem Sie das HDATA_APPOWNED-Flag in einem Aufruf von DdeCreateDataHandle angeben
  • So geben Sie ein DDE-Objekt frei, dessen Handle die Anwendung von der DdeClientTransaction-Funktion empfangen hat
Das System gibt ein nicht verwaltetes Objekt automatisch frei, wenn sein Handle von einer DDE-Rückruffunktion zurückgegeben oder als Parameter in einer DDEML-Funktion verwendet wird.

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

DdeAccessData

DdeClientTransaction

DdeCreateDataHandle

Verwaltungsbibliothek für dynamische Daten

Referenz