DdeKeepStringHandle-Funktion (ddeml.h)

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

Weitere Informationen

CONVINFO

Konzept

DdeCreateStringHandle

DdeFreeStringHandle

DdeInitialize

DdeQueryConvInfo

DdeQueryString

Dynamic Data Exchange Management Library

Referenz