The DdeFreeStringHandle function frees a string handle in the calling application.
BOOL DdeFreeStringHandle(
| DWORD idInst, | // instance identifier |
| HSZ hsz | // handle to string |
| ); |
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 Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Remarks
An application can free string handles it creates with DdeCreateStringHandle 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.
See Also
CONVINFO, DdeCmpStringHandles, DdeCreateStringHandle, DdeInitialize, DdeKeepStringHandle, DdeQueryConvInfo, DdeQueryString