WM_DDE_DATA mensagem

  • Artigo

Um aplicativo de servidor DDE (Troca Dinâmica de Dados) posta uma mensagem WM_DDE_DATA em um aplicativo cliente DDE para passar um item de dados para o cliente ou para notificar o cliente sobre a disponibilidade de um item de dados.

Para postar essa mensagem, chame a função PostMessage com os parâmetros a seguir.

#define WM_DDE_DATA        0x03E05

Parâmetros

wParam

Um identificador para a janela do servidor postando a mensagem.

lParam

A palavra de baixa ordem é um identificador para um objeto de memória global que contém uma estrutura DDEDATA com os dados e informações adicionais. O identificador deverá ser definido como NULL se o servidor estiver notificando o cliente de que o valor do item de dados foi alterado durante um link de dados quentes. Um link quente é estabelecido pelo cliente que envia uma mensagem WM_DDE_ADVISE com o conjunto de bits fDeferUpd .

A palavra de alta ordem contém um átomo que identifica o item de dados para o qual os dados ou a notificação são enviados.

Comentários

Cartazes

O aplicativo de servidor aloca o objeto de memória global usando a função GlobalAlloc . Ele aloca o átomo usando a função GlobalAddAtom .

O servidor deve criar ou reutilizar o parâmetro lParamWM_DDE_DATA chamando a função PackDDElParam ou a função ReuseDDElParam.

Se o aplicativo de recebimento (cliente) responder com uma mensagem de WM_DDE_ACK negativa, o aplicativo de postagem (servidor) deverá excluir o objeto de memória global; caso contrário, o cliente deve excluir o objeto depois de extrair seu conteúdo chamando a função UnpackDDElParam .

Se o aplicativo de servidor definir o membro fRelease da estrutura DDEDATA como FALSE, o servidor será responsável por excluir o objeto ao receber uma confirmação positiva ou negativa.

O aplicativo de servidor não deve definir os membros fAckReq e fRelease da estrutura DDEDATA como FALSE. Se ambos os membros estiverem definidos como FALSE, é impossível para o servidor determinar quando excluir o objeto.

Recebimento

Se fAckReq for TRUE, o aplicativo cliente deverá postar a mensagem WM_DDE_ACK para responder positiva ou negativamente. Ao postar WM_DDE_ACK, o cliente pode reutilizar o átomo ou pode excluí-lo e criar um novo.

O cliente deve criar ou reutilizar o parâmetro lParamWM_DDE_ACK chamando a função PackDDElParam ou a função ReuseDDElParam.

Se fAckReq for FALSE, o aplicativo cliente deverá excluir o átomo.

Se o aplicativo de postagem especificar o objeto de memória global como NULL, o aplicativo receptor poderá solicitar que o servidor envie os dados postando uma mensagem WM_DDE_REQUEST .

Depois de processar um WM_DDE_DATA mensagem na qual o objeto de memória global não é NULL, o cliente deve liberar o objeto, a menos que uma das seguintes condições seja verdadeira:

  • O membro fRelease é FALSE.
  • O membro fRelease é TRUE, mas o aplicativo cliente responde com uma mensagem de WM_DDE_ACK negativa.

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
Dde.h (inclua Windows.h)

Confira também

Referência

DDEDATA

FreeDDElParam

Globaladdatom

PackDDElParam

PostMessage

ReuseDDElParam

Sendmessage

UnpackDDElParam

WM_DDE_ACK

WM_DDE_ADVISE

WM_DDE_POKE

WM_DDE_REQUEST

Conceitual

Sobre a Troca Dinâmica de Dados