Skip to content

Latest commit

 

History

History
107 lines (74 loc) · 3.76 KB

nf-ddeml-ddefreedatahandle.md

File metadata and controls

107 lines (74 loc) · 3.76 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:ddeml.DdeFreeDataHandle
DdeFreeDataHandle function (ddeml.h)
Frees a Dynamic Data Exchange (DDE) object and deletes the data handle associated with the object.
DdeFreeDataHandle
DdeFreeDataHandle function [Data Exchange]
_win32_DdeFreeDataHandle
_win32_ddefreedatahandle_cpp
dataxchg.ddefreedatahandle
ddeml/DdeFreeDataHandle
winui._win32_ddefreedatahandle
dataxchg\ddefreedatahandle.htm
dataxchg
VS|winui|~\winui\windowsuserinterface\dataexchange\dynamicdataexchangemanagementlibrary\dynamicdataexchangemanagementreference\dynamicdataexchangemanagementfunctions\ddefreedatahandle.htm
12/05/2018
DdeFreeDataHandle, DdeFreeDataHandle function [Data Exchange], _win32_DdeFreeDataHandle, _win32_ddefreedatahandle_cpp, dataxchg.ddefreedatahandle, ddeml/DdeFreeDataHandle, winui._win32_ddefreedatahandle
ddeml.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
User32.lib
User32.dll
Windows
19H1
DdeFreeDataHandle
ddeml/DdeFreeDataHandle
c++
APIRef
kbSyntax
DllExport
User32.dll
DdeFreeDataHandle

DdeFreeDataHandle function

-description

Frees a Dynamic Data Exchange (DDE) object and deletes the data handle associated with the object.

-parameters

-param hData [in]

Type: HDDEDATA

A handle to 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.

-returns

Type: BOOL

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:

-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

Conceptual

DdeAccessData

DdeClientTransaction

DdeCreateDataHandle

Dynamic Data Exchange Management Library

Reference