Estrutura MONLINKSTRUCT (ddeml.h)

Artigo
02/29/2024

Contém informações sobre um loop de aconselhamento do DDE (Troca Dinâmica de Dados). Um aplicativo de monitoramento de DDE pode usar essa estrutura para obter informações sobre um loop de aconselhamento que foi iniciado ou encerrado.

Sintaxe

typedef struct tagMONLINKSTRUCT {
  UINT   cb;
  DWORD  dwTime;
  HANDLE hTask;
  BOOL   fEstablished;
  BOOL   fNoData;
  HSZ    hszSvc;
  HSZ    hszTopic;
  HSZ    hszItem;
  UINT   wFmt;
  BOOL   fServer;
  HCONV  hConvServer;
  HCONV  hConvClient;
} MONLINKSTRUCT, *PMONLINKSTRUCT;

Membros

cb

Tipo: UINT

O tamanho da estrutura, em bytes.

dwTime

Tipo: DWORD

A hora do Windows em que o loop de aconselhamento foi iniciado ou encerrado. O tempo do Windows é o número de milissegundos decorridos desde que o sistema foi inicializado.

hTask

Tipo: HANDLE

Um identificador para uma tarefa (instância de aplicativo) que é um parceiro no loop de aconselhamento.

fEstablished

Tipo: BOOL

Indica se um loop de aconselhamento foi estabelecido com êxito. Um valor true indica que um loop de aconselhamento foi estabelecido; FALSE indica que não foi.

fNoData

Tipo: BOOL

Indica se o sinalizador XTYPF_NODATA está definido para o loop de aconselhamento. Um valor true indica que o sinalizador está definido; FALSE indica que não é.

hszSvc

Tipo: HSZ

Um identificador para o nome do serviço do servidor no loop de aconselhamento.

hszTopic

Tipo: HSZ

Um identificador para o nome do tópico no qual o loop de aconselhamento é estabelecido.

hszItem

Tipo: HSZ

Um identificador para o nome do item que é o assunto do loop de aconselhamento.

wFmt

Tipo: UINT

O formato dos dados trocados (se houver) durante o loop de aconselhamento.

fServer

Tipo: BOOL

Indica se a notificação de link veio do servidor. Um valor true indica que a notificação veio do servidor; FALSE indica o contrário.

hConvServer

Tipo: HCONV

Um identificador para a conversa do servidor.

hConvClient

Tipo: HCONV

Um identificador para a conversa do cliente.

Comentários

Como os identificadores de cadeia de caracteres são locais para o processo, os membros hszSvc, hszTopic e hszItem são átomos globais.

Os membros hConvClient e hConvServer da estrutura MONLINKSTRUCT não têm o mesmo valor que seria visto pelos aplicativos envolvidos na conversa. Em vez disso, eles mantêm um par globalmente exclusivo de valores que identificam a conversa.

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