Windows Dev Center

DdeFreeStringHandle function

Frees a string handle in the calling application.

Syntax


BOOL WINAPI DdeFreeStringHandle(
  _In_ DWORD idInst,
  _In_ HSZ   hsz
);

Parameters

idInst [in]

Type: DWORD

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

hsz [in]

Type: HSZ

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

Return value

Type: BOOL

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ddeml.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
CONVINFO
DdeCmpStringHandles
DdeCreateStringHandle
DdeInitialize
DdeKeepStringHandle
DdeQueryConvInfo
DdeQueryString
Conceptual
Dynamic Data Exchange Management Library

 

 

Community Additions

ADD
Show:
© 2015 Microsoft