DdeFreeStringHandle

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

The DdeFreeStringHandle function frees a string handle in the calling application.

Parameters

idInst

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

hsz

Identifies the string handle to be freed. This handle must have been created by a previous call to the DdeCreateStringHandle function.

Return Value

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

Comments

An application can free string handles that it creates with the DdeCreateStringHandle function but should not free those that the system passed to the application's dynamic data exchange (DDE) callback function or those returned in the CONVINFO structure by the DdeQueryConvInfo function.