DdeFreeDataHandle-Funktion (ddeml.h)

Artikel
02/29/2024

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