Estrutura CONVINFO (ddeml.h)

  • Artigo

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)

Confira também

CONVCONTEXT

Conceitual

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

Biblioteca de Gerenciamento dinâmico do Data Exchange

Referência