messaggio WM_DDE_INITIATE

Un'applicazione client DDE (Dynamic Data Exchange) invia un messaggio di WM_DDE_INITIATE per avviare una conversazione con un'applicazione server che risponde ai nomi dell'applicazione e degli argomenti specificati. Al momento della ricezione di questo messaggio, tutte le applicazioni server con nomi corrispondenti all'applicazione specificata e che supportano l'argomento specificato devono confermarlo. Per altre informazioni, vedere il messaggio WM_DDE_ACK .

#define WM_DDE_INITIATE        0x03E0

Parametri

wParam

Handle per la finestra client che invia il messaggio.

lParam

La parola in ordine basso contiene un atomo che identifica l'applicazione con cui viene richiesta una conversazione. Il nome dell'applicazione non può contenere barre (/) o barre rovesciata (\). Questi caratteri sono riservati per le implementazioni di rete. Se questo parametro è NULL, viene richiesta una conversazione con tutte le applicazioni.

La parola di ordine elevato contiene un atomo che identifica l'argomento per il quale viene richiesta una conversazione. Se l'argomento è NULL, vengono richieste conversazioni per tutti gli argomenti disponibili.

Commenti

Se la parola in ordine basso di lParam è NULL, qualsiasi applicazione server può rispondere. Se la parola di ordine elevato di lParam è NULL, qualsiasi argomento è valido. Quando si riceve una richiesta di WM_DDE_INITIATE con la parola di ordine elevato del parametro lParam impostata su NULL, un server deve inviare un messaggio di WM_DDE_ACK per ognuno degli argomenti supportati.

Invio

Il client trasmette il messaggio a tutte le finestre di primo livello impostando il primo parametro di SendMessage su HWND_BROADCAST.

Se l'applicazione client ha già ottenuto l'handle di finestra del server desiderato, può inviare WM_DDE_INITIATE direttamente alla finestra del server passando l'handle della finestra del server come primo parametro di SendMessage.

L'applicazione client alloca gli atom chiamando la funzione GlobalAddAtom .

Quando SendMessage viene restituito, l'applicazione client deve eliminare gli atom.

Ricezione

Per completare l'avvio di una conversazione, l'applicazione server deve rispondere con uno o più messaggi WM_DDE_ACK , in cui ogni messaggio è destinato a un argomento separato. Quando si invia WM_DDE_ACK messaggio, il server deve creare nuovi atomi; non deve riutilizzare gli atomi inviati con WM_DDE_INITIATE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Dde.h (include Windows.h)

Vedi anche

Riferimento

GlobalAddAtom

PostMessage

SendMessage

WM_DDE_ACK

Informazioni concettuali

Informazioni su Dynamic Data Exchange