DdeFreeStringHandle-Funktion (ddeml.h)

Artikel
02/26/2024

Gibt ein Zeichenfolgenhandle in der aufrufenden Anwendung frei.

Syntax

BOOL DdeFreeStringHandle(
  [in] DWORD idInst,
  [in] HSZ   hsz
);

Parameter

[in] idInst

Art: DWORD

Die Anwendung instance Bezeichner, der durch einen vorherigen Aufruf der DdeInitialize-Funktion abgerufen wurde.

[in] hsz

Typ: HSZ

Ein Handle für das zu freigebende Zeichenfolgenhandle. Dieses Handle muss durch einen vorherigen Aufruf der DdeCreateStringHandle-Funktion erstellt 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.

Hinweise

Eine Anwendung kann Zeichenfolgenhandles freigeben, die sie mit DdeCreateStringHandle erstellt, sollte jedoch nicht diejenigen freigeben, die das System an die DDE-Rückruffunktion (Dynamic Data Exchange) der Anwendung übergeben hat oder die in der CONVINFO-Struktur von der DdeQueryConvInfo-Funktion zurückgegeben werden.

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