Platform SDK: Interprocess Communications |
The DdeFreeDataHandle function frees a dynamic data exchange (DDE) object and deletes the data handle associated with the object.
BOOL DdeFreeDataHandle( HDDEDATA hData // handle to DDE object );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
The DdeGetLastError function can be used to get the error code, which can be one of the following values:
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
An application must call DdeFreeDataHandle under the following circumstances:
The system automatically frees an unowned object when its handle is returned by a DDE callback function or is used as a parameter in a DDEML function.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Ddeml.h; include Windows.h.
Library: Use User32.lib.
Dynamic Data Exchange Management Library Overview, Dynamic Data Exchange Management Functions, DdeAccessData, DdeCreateDataHandle, DdeClientTransaction