Função DdeQueryConvInfo (ddeml.h)
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 |
Confira também
Conceitual
Biblioteca de Gerenciamento dinâmico do Data Exchange
Referência