WM_DDE_DATA mensagem
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 |
|