Função DdeQueryConvInfo (ddeml.h)

Artigo
08/23/2023

Recupera informações sobre uma transação DDE (Troca Dinâmica de Dados) e sobre a conversa na qual a transação ocorre.

Sintaxe

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Parâmetros

[in] hConv

Tipo: HCONV

Um identificador para a conversa.

[in] idTransaction

Tipo: DWORD

A transação. Para transações assíncronas, esse parâmetro deve ser um identificador de transação retornado pela função DdeClientTransaction . Para transações síncronas, esse parâmetro deve ser QID_SYNC.

[in, out] pConvInfo

Tipo: PCONVINFO

Um ponteiro para a estrutura CONVINFO que recebe informações sobre a transação e a conversa. O membro cb da estrutura CONVINFO deve especificar o comprimento do buffer alocado para a estrutura.

Retornar valor

Tipo: UINT

Se a função for bem-sucedida, o valor retornado será o número de bytes copiados para a estrutura CONVINFO .

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

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 não deve liberar um identificador de cadeia de caracteres referenciado pela estrutura CONVINFO . Se um aplicativo precisar usar um desses identificadores de cadeia de caracteres, ele deverá chamar a função DdeKeepStringHandle para criar uma cópia do identificador.

Se o parâmetro idTransaction estiver definido como QID_SYNC, o membro hUser da estrutura CONVINFO será associado à conversa e poderá ser usado para armazenar dados associados à conversa. Se idTransaction for o identificador de uma transação assíncrona, o membro hUser será associado somente à transação atual e será válido apenas durante a transação.

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