Edit

DdeKeepStringHandle function (ddeml.h)

  • Article

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(
  [in] DWORD idInst,
  [in] HSZ   hsz
);

Parameters

[in] idInst

Type: DWORD

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

[in] 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

Requirement Value
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