Função DdeFreeDataHandle (ddeml.h)

Artigo
02/26/2024

Libera um objeto DDE (Troca Dinâmica de Dados) e exclui o identificador de dados associado ao objeto .

Sintaxe

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Parâmetros

[in] hData

Tipo: HDDEDATA

Um identificador para o objeto DDE a ser liberado. Esse identificador deve ter sido criado por uma chamada anterior para a função DdeCreateDataHandle ou retornado pela função DdeClientTransaction .

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

Um aplicativo deve chamar DdeFreeDataHandle nas seguintes circunstâncias:

Para liberar um objeto DDE alocado pelo aplicativo chamando a função DdeCreateDataHandle se o identificador de dados do objeto nunca foi passado pelo aplicativo para outra função DDEML (Dynamic Data Exchange Management Library)
Para liberar um objeto DDE alocado pelo aplicativo especificando o sinalizador HDATA_APPOWNED em uma chamada para DdeCreateDataHandle
Para liberar um objeto DDE cujo identificador o aplicativo recebeu da função DdeClientTransaction

O sistema libera automaticamente um objeto sem proprietário quando seu identificador é retornado por uma função de retorno de chamada DDE ou é usado como um parâmetro em uma função DDEML.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll