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
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
Verwaltungsbibliothek für dynamische Daten
Referenz