Função DdeFreeStringHandle (ddeml.h)

Artigo
02/29/2024

Libera um identificador de cadeia de caracteres no aplicativo de chamada.

Sintaxe

BOOL DdeFreeStringHandle(
  [in] DWORD idInst,
  [in] HSZ   hsz
);

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in] hsz

Tipo: HSZ

Um identificador para o identificador de cadeia de caracteres a ser liberado. Esse identificador deve ter sido criado por uma chamada anterior para a função DdeCreateStringHandle .

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.

Comentários

Um aplicativo pode liberar identificadores de cadeia de caracteres que cria com DdeCreateStringHandle , mas não deve liberar aqueles que o sistema passou para a função de retorno de chamada DDE (Dynamic Data Exchange) do aplicativo ou aqueles retornados na estrutura CONVINFO pela função DdeQueryConvInfo .

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