Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

DdeKeepStringHandle function (ddeml.h)

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


Feedback

Was this page helpful?

Additional resources