DdeKeepStringHandle-Funktion (ddeml.h)

Artikel
08/23/2023

Erhöht die Nutzungsanzahl, die dem angegebenen Handle zugeordnet ist. Mit dieser Funktion kann eine Anwendung ein Zeichenfolgenhandle speichern, das an die DDE-Rückruffunktion (Dynamic Data Exchange) der Anwendung übergeben wird. Andernfalls wird ein an die Rückruffunktion übergebenes Zeichenfolgenhandle gelöscht, wenn die Rückruffunktion zurückgegeben wird. Diese Funktion sollte auch verwendet werden, um eine Kopie eines Zeichenfolgenhandles beizubehalten, auf das von der CONVINFO-Struktur verwiesen wird, die von der DdeQueryConvInfo-Funktion zurückgegeben wird.

Syntax

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

Parameter

[in] idInst

Art: DWORD

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

[in] hsz

Typ: HSZ

Ein Handle für das zu speichernde Zeichenfolgenhandle.

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.

Anforderungen


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 (Windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll