DdeFreeStringHandle  1.6N_OH 

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 DdeInitialize1_PFUXK function.

hsz

Identifies the string handle to be freed. This handle must have been created by a previous call to the DdeCreateStringHandleF7Z406 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 CONVINFO8EBXHJ structure by the DdeQueryConvInfo function.

See Also

CONVINFO, DdeCmpStringHandles, DdeCreateStringHandle, DdeInitialize, DdeKeepStringHandle, DdeQueryConvInfo, DdeQueryString