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
Conceptual
Dynamic Data Exchange Management Library
Reference