Platform SDK: Interprocess Communications |
The 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.
BOOL DdeKeepStringHandle( DWORD idInst, // instance identifier HSZ hsz // handle to string );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Ddeml.h; include Windows.h.
Library: Use User32.lib.
Dynamic Data Exchange Management Library Overview, Dynamic Data Exchange Management Functions, CONVINFO, DdeCreateStringHandle, DdeFreeStringHandle, DdeInitialize, DdeQueryConvInfo, DdeQueryString