DdeKeepStringHandle

BOOL DdeKeepStringHandle(idInst, hsz)
DWORD idInst;	/* instance identifier	*/
HSZ hsz;	/* handle of string	*/

The DdeKeepStringHandle function increments the usage count (increases it by one) associated with the given handle. This function makes it possible for an application to save a string handle that was 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.

Parameters

idInst

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

hsz

Identifies the string handle to be saved.

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.