DdeKeepStringHandle function

Increments the usage count associated with the specified handle. This function enables an application to save a string handle passed to the application's Dynamic Data Exchange (DDE) callback function. Otherwise, a string handle passed to the callback function is deleted when the callback function returns. This function should also be used to keep a copy of a string handle referenced by the CONVINFO structure returned by the DdeQueryConvInfo function.

Syntax

BOOL DdeKeepStringHandle(
  DWORD idInst,
  HSZ   hsz
);

Parameters

idInst

Type: DWORD

The application instance identifier obtained by a previous call to the DdeInitialize function.

hsz

Type: HSZ

A handle to the string handle to be saved.

Return value

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ddeml.h (include Windows.h)
Library User32.lib
DLL User32.dll

See also

CONVINFO

Conceptual

DdeCreateStringHandle

DdeFreeStringHandle

DdeInitialize

DdeQueryConvInfo

DdeQueryString

Dynamic Data Exchange Management Library

Reference