Estrutura CONVINFO (ddeml.h)

Artigo
08/23/2023

Contém informações sobre uma conversa de DDE (Troca Dinâmica de Dados).

Sintaxe

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

Membros

cb

Tipo: DWORD

O tamanho da estrutura, em bytes.

hUser

Tipo: DWORD_PTR

Dados definidos pelo aplicativo.

hConvPartner

Tipo: HCONV

Um identificador para o aplicativo parceiro na conversa DDE. Esse membro será zero se o parceiro não tiver se registrado (usando a função DdeInitialize ) para fazer chamadas de função DDEML. Um aplicativo não deve passar esse membro para nenhuma função DDEML, exceto DdeQueryConvInfo.

hszSvcPartner

Tipo: HSZ

Um identificador para o nome do serviço do aplicativo parceiro.

hszServiceReq

Tipo: HSZ

Um identificador para o nome do serviço do aplicativo de servidor que foi solicitado para conexão.

hszTopic

Tipo: HSZ

Um identificador para o nome do tópico solicitado.

hszItem

Tipo: HSZ

Um identificador para o nome do item solicitado. Esse membro é específico da transação.

wFmt

Tipo: UINT

O formato dos dados que estão sendo trocados. Esse membro é específico da transação.

wType

Tipo: UINT

O tipo da transação atual. Esse membro é específico da transação; pode ser um dos valores a seguir.

Valor	Significado
XTYP_ADVDATA 0x4010	Informa a um cliente que os dados de consultoria de um servidor chegaram.
XTYP_ADVREQ 0x2022	Solicita que um servidor envie dados atualizados para o cliente durante um loop de consultoria. Essa transação resulta quando o servidor chama DdePostAdvise.
XTYP_ADVSTART 0x1030	Solicita que um servidor inicie um loop de consultoria com um cliente.
XTYP_ADVSTOP 0x8040	Notifica um servidor de que um loop de aviso está parando.
XTYP_CONNECT 0x1062	Solicita que um servidor estabeleça uma conversa com um cliente.
XTYP_CONNECT_CONFIRM 0x8072	Notifica um servidor de que uma conversa com um cliente foi estabelecida.
XTYP_DISCONNECT 0x80C2	Notifica um servidor de que uma conversa foi encerrada.
XTYP_EXECUTE 0x4050	Solicita que um servidor execute um comando enviado por um cliente.
XTYP_MONITOR 0x80F2	Notifica um aplicativo registrado como APPCMD_MONITOR que os dados DDE estão sendo transmitidos.
XTYP_POKE 0x4090	Solicita que um servidor aceite dados não solicitados de um cliente.
XTYP_REGISTER 0x80A2	Notifica outros aplicativos DDEML de que um servidor registrou um nome de serviço.
XTYP_REQUEST 0x20B0	Solicita que um servidor envie dados para um cliente.
XTYP_UNREGISTER 0x80D2	Notifica outros aplicativos DDEML de que um servidor cancelou o registro de um nome de serviço.
XTYP_WILDCONNECT 0x20E2	Solicita que um servidor estabeleça várias conversas com o mesmo cliente.
XTYP_XACT_COMPLETE 0x8080	Notifica um cliente de que uma transação de dados assíncrona foi concluída.

wStatus

Tipo: UINT

O status da conversa atual. Esse membro pode ser um ou mais dos valores a seguir.

Valor	Significado
ST_ADVISE 0x0002	Um ou mais links estão em andamento.
ST_BLOCKED 0x0008	A conversa está bloqueada.
ST_BLOCKNEXT 0x0080	A conversa será bloqueada depois de chamar o próximo retorno de chamada.
ST_CLIENT 0x0010	O identificador con0x0010versation passado para a função DdeQueryConvInfo é um identificador do lado do cliente. Se o identificador for zero, o identificador de conversa passado para a função DdeQueryConvInfo será um identificador do lado do servidor.
ST_CONNECTED 0x0001	A conversa está conectada.
ST_INLIST 0x0040	A conversa é membro de uma lista de conversas.
ST_ISLOCAL 0x0004	Ambos os lados da conversa estão usando o DDEML.
ST_ISSELF 0x0100	Ambos os lados da conversa estão usando a mesma instância do DDEML.
ST_TERMINATED 0x0020	A conversa foi encerrada pelo parceiro.

wConvst

Tipo: UINT

O estado da conversa. Esse membro pode ser um dos valores a seguir.

Valor	Significado
XST_ADVACKRCVD 13	A transação de aviso acabou de ser concluída.
XST_ADVDATAACKRCVD 16	A transação de dados de aviso acabou de ser concluída.
XST_ADVDATASENT 15	Informe que os dados foram enviados e estão aguardando uma confirmação.
XST_ADVSENT 11	Uma transação de consultoria está aguardando uma confirmação.
XST_CONNECTED 2	A conversa não tem transações ativas.
XST_DATARCVD 6	Os dados solicitados acabaram de ser recebidos.
XST_EXECACKRCVD 10	Uma transação de execução acabou de ser concluída.
XST_EXECSENT 9	Uma transação de execução está aguardando uma confirmação.
XST_INCOMPLETE 1	A última transação falhou.
XST_INIT1 3	Estado de início médio 1.
XST_INIT2 4	Estado de início médio 2.
XST_NULL 0	Estado de pré-início.
XST_POKEACKRCVD 8	Uma transação de cutucada acabou de ser concluída.
XST_POKESENT 7	Uma transação de cutucada está aguardando uma confirmação.
XST_REQSENT 5	Uma transação de solicitação está aguardando uma confirmação.
XST_UNADVACKRCVD 14	Uma transação não planejada acabou de ser concluída.
XST_UNADVSENT 12	Uma transação não planejada está aguardando uma confirmação.

wLastError

Tipo: UINT

O valor de erro associado à última transação.

hConvList

Tipo: HCONVLIST

Um identificador para a lista de conversas se o identificador da conversa atual estiver em uma lista de conversas. Esse membro será NULL se a conversa não estiver em uma lista de conversas.

ConvCtxt

Tipo: CONVCONTEXT

O contexto da conversa.

hwnd

Digite: HWND

Um identificador para a janela do aplicativo de chamada envolvido na conversa.

hwndPartner

Digite: HWND

Um identificador para a janela do aplicativo parceiro envolvido na conversa atual.

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]
Cabeçalho	ddeml.h (inclua Windows.h)