WM_DDE_POKE mensagem

Um aplicativo cliente DDE (Troca Dinâmica de Dados) posta uma mensagem WM_DDE_POKE em um aplicativo de servidor DDE. Um cliente usa essa mensagem para solicitar que o servidor aceite um item de dados não solicitado. Espera-se que o servidor responda com uma mensagem WM_DDE_ACK indicando se ele aceitou o item de dados.

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

#define WM_DDE_POKE        0x03E7

Parâmetros

wParam

Um identificador para a janela do cliente postando a mensagem.

lParam

A palavra de baixa ordem é um identificador para um objeto de memória global que contém uma estrutura DDEPOKE com os dados e informações adicionais.

A palavra de alta ordem contém um atom global que identifica o item de dados para o qual os dados ou a notificação estão sendo enviados.

Comentários

Cartazes

O aplicativo cliente deve alocar memória para o objeto de memória global usando a função GlobalAlloc . O aplicativo cliente deverá excluir o objeto se uma das seguintes condições for verdadeira:

  • O aplicativo de servidor responde com uma mensagem de WM_DDE_ACK negativa.
  • O membro fRelease é FALSE, mas o aplicativo de servidor responde com uma WM_DDE_ACK positiva ou negativa.

O aplicativo cliente deve criar o atom usando a função GlobalAddAtom .

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

Recebimento

O aplicativo de servidor deve postar a mensagem WM_DDE_ACK para responder positiva ou negativamente. Ao postar WM_DDE_ACK, o servidor pode reutilizar o atom ou pode excluí-lo e criar um novo.

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

Para liberar o objeto de memória global, o servidor deve chamar a função GlobalFree . Além disso, se o formato de dados for CF_DSPMETAFILEPICT ou CF_METAFILEPICT, o servidor também deverá chamar DeleteMetaFile com o identificador de meta-arquivo inserido. Esses dois formatos têm um nível extra de indireção; ou seja, um aplicativo deve bloquear o objeto para obter um ponteiro para um identificador e, em seguida, bloquear esse identificador para obter um ponteiro para uma estrutura METAFILEPICT e, por fim, chamar DeleteMetaFile com o identificador do membro hMF da estrutura METAFILEPICT .

Para liberar o objeto , o servidor deve chamar a função FreeDDElParam .

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

Confira também

Referência

DDEPOKE

FreeDDElParam

Globaladdatom

METAFILEPICT

PackDDElParam

PostMessage

ReuseDDElParam

Sendmessage

UnpackDDElParam

WM_DDE_ACK

Conceitual

Sobre a Troca Dinâmica de Dados