|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| ddeml.h
| Unicode
| No
| Platform Notes
| None
|
|
|
DdeFreeDataHandle
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
| );
|
|
Parameters
hData
Identifies the DDE object to be freed. This handle must have been created by a
previous call to the DdeCreateDataHandle function or returned by the DdeClientTransaction function.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Errors
The DdeGetLastError function can be used to get the error code, which may be one of the following
values:
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
Remarks
An application must call DdeFreeDataHandle under the following circumstances:
- To free a DDE object that the application allocated by calling the DdeCreateDataHandle function if the object's data handle was never passed by the application to
another Dynamic Data Exchange Management Library (DDEML) function
- To free a DDE object that the application allocated by specifying the
HDATA_APPOWNED flag in a call to DdeCreateDataHandle
- To free a DDE object whose handle the application received from the DdeClientTransaction function
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.
See Also
DdeAccessData, DdeCreateDataHandle, DdeClientTransaction
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
