Função DdeSetUserHandle (ddeml.h)

Associa um valor definido pelo aplicativo a um identificador de conversa ou um identificador de transação. Isso é útil para simplificar o processamento de transações assíncronas. Um aplicativo pode usar a função DdeQueryConvInfo para recuperar esse valor.

Sintaxe

BOOL DdeSetUserHandle(
  [in] HCONV     hConv,
  [in] DWORD     id,
  [in] DWORD_PTR hUser
);

Parâmetros

[in] hConv

Tipo: HCONV

Um identificador para a conversa.

[in] id

Tipo: DWORD

O identificador de transação a ser associado ao valor especificado pelo parâmetro hUser . Um aplicativo deve definir esse parâmetro como QID_SYNC para associar hUser à conversa identificada pelo parâmetro hConv .

[in] hUser

Tipo: DWORD_PTR

O valor a ser associado ao identificador de conversa.

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:

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

Confira também

Conceitual

DdeQueryConvInfo

Biblioteca de Gerenciamento de Troca dinâmica de dados

Referência