Função DdeKeepStringHandle (ddeml.h)

Artigo
08/23/2023

Incrementa a contagem de uso associada ao identificador especificado. Essa função permite que um aplicativo salve um identificador de cadeia de caracteres passado para a função de retorno de chamada DDE (Dynamic Data Exchange) do aplicativo. Caso contrário, um identificador de cadeia de caracteres passado para a função de retorno de chamada é excluído quando a função de retorno de chamada retorna. Essa função também deve ser usada para manter uma cópia de um identificador de cadeia de caracteres referenciado pela estrutura CONVINFO retornada pela função DdeQueryConvInfo .

Sintaxe

BOOL DdeKeepStringHandle(
  [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 salvo.

Valor retornado

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.

Requisitos


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