Función DdeFreeDataHandle (ddeml.h)

Artículo
08/23/2023

Libera un objeto de intercambio de datos dinámicos (DDE) y elimina el identificador de datos asociado al objeto .

Sintaxis

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Parámetros

[in] hData

Tipo: HDDEDATA

Identificador del objeto DDE que se va a liberar. Este identificador debe haber sido creado por una llamada anterior a la función DdeCreateDataHandle o devuelto por la función DdeClientTransaction .

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

La función DdeGetLastError se puede usar para obtener el código de error, que puede ser uno de los siguientes valores:

Comentarios

Una aplicación debe llamar a DdeFreeDataHandle en las siguientes circunstancias:

Para liberar un objeto DDE que la aplicación asignó mediante una llamada a la función DdeCreateDataHandle si la aplicación nunca pasó el identificador de datos del objeto a otra función de la biblioteca de administración dinámica de Exchange de datos (DDEML)
Para liberar un objeto DDE que la aplicación asignó especificando la marca de HDATA_APPOWNED en una llamada a DdeCreateDataHandle
Para liberar un objeto DDE cuyo identificador ha recibido la aplicación de la función DdeClientTransaction

El sistema libera automáticamente un objeto no propietario cuando una función de devolución de llamada DDE devuelve su identificador o se usa como parámetro en una función DDEML.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ddeml.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll