Compartilhar via


WM_DDE_INITIATE mensagem

Um aplicativo cliente DDE (Troca Dinâmica de Dados) envia uma mensagem WM_DDE_INITIATE para iniciar uma conversa com um aplicativo de servidor respondendo aos nomes de aplicativo e tópico especificados. Ao receber essa mensagem, todos os aplicativos de servidor com nomes que correspondem ao aplicativo especificado e que dão suporte ao tópico especificado devem reconhecê-lo. (Para obter mais informações, consulte a mensagem WM_DDE_ACK .)

#define WM_DDE_INITIATE        0x03E0

Parâmetros

wParam

Um identificador para a janela do cliente que envia a mensagem.

lParam

A palavra de baixa ordem contém um atom que identifica o aplicativo com o qual uma conversa é solicitada. O nome do aplicativo não pode conter barras (/) ou barras invertidas (\). Esses caracteres são reservados para implementações de rede. Se esse parâmetro for NULL, uma conversa com todos os aplicativos será solicitada.

A palavra de alta ordem contém um átomo que identifica o tópico para o qual uma conversa é solicitada. Se o tópico for NULL, as conversas para todos os tópicos disponíveis serão solicitadas.

Comentários

Se a palavra de baixa ordem de lParam for NULL, qualquer aplicativo de servidor poderá responder. Se a palavra de alta ordem de lParam for NULL, qualquer tópico será válido. Ao receber uma solicitação WM_DDE_INITIATE com a palavra de alta ordem do parâmetro lParam definida como NULL, um servidor deve enviar uma mensagem WM_DDE_ACK para cada um dos tópicos aos quais dá suporte.

Envio

O cliente transmite a mensagem para todas as janelas de nível superior definindo o primeiro parâmetro de SendMessage como HWND_BROADCAST.

Se o aplicativo cliente já tiver obtido o identificador de janela do servidor desejado, ele poderá enviar WM_DDE_INITIATE diretamente para a janela do servidor passando o identificador de janela do servidor como o primeiro parâmetro de SendMessage.

O aplicativo cliente aloca atoms chamando a função GlobalAddAtom .

Quando SendMessage retorna, o aplicativo cliente deve excluir os atoms.

Recebimento

Para concluir o início de uma conversa, o aplicativo de servidor deve responder com uma ou mais mensagens WM_DDE_ACK , em que cada mensagem é para um tópico separado. Ao enviar WM_DDE_ACK mensagem, o servidor deve criar novos atoms; não deve reutilizar os átomos enviados com WM_DDE_INITIATE.

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

Globaladdatom

PostMessage

Sendmessage

WM_DDE_ACK

Conceitual

Sobre a Troca Dinâmica de Dados