WM_DDE_POKE message

Une application cliente DDE (Dynamic Data Exchange) publie un message WM_DDE_POKE à une application serveur DDE. Un client utilise ce message pour demander au serveur d’accepter un élément de données non sollicité. Le serveur est censé répondre avec un message WM_DDE_ACK indiquant s’il a accepté l’élément de données.

Pour publier ce message, appelez la fonction PostMessage avec les paramètres suivants.

#define WM_DDE_POKE        0x03E7

Paramètres

wParam

Handle dans la fenêtre cliente qui publie le message.

lParam

Le mot de bas ordre est un handle pour un objet mémoire global contenant une structure DDEPOKE avec les données et des informations supplémentaires.

Le mot d’ordre supérieur contient un atome global qui identifie l’élément de données pour lequel les données ou la notification sont envoyées.

Notes

Affichage

L’application cliente doit allouer de la mémoire à l’objet mémoire globale à l’aide de la fonction GlobalAlloc . L’application cliente doit supprimer l’objet si l’une des conditions suivantes est remplie :

• L’application serveur répond avec un message de WM_DDE_ACK négatif.
• Le membre fRelease a la valeur FALSE, mais l’application serveur répond avec un WM_DDE_ACK positif ou négatif.

L’application cliente doit créer l’atome à l’aide de la fonction GlobalAddAtom .

L’application cliente doit créer ou réutiliser le paramètre WM_DDE_POKElParam en appelant la fonction PackDDElParam ou la fonction ReuseDDElParam .

Réception

L’application serveur doit publier le message WM_DDE_ACK pour répondre positivement ou négativement. Lors de la publication d’WM_DDE_ACK, le serveur peut réutiliser l’atome ou le supprimer et en créer un nouveau.

Le serveur doit créer ou réutiliser le paramètre WM_DDE_ACKlParam en appelant la fonction PackDDElParam ou la fonction ReuseDDElParam .

Pour libérer l’objet mémoire globale, le serveur doit appeler la fonction GlobalFree . En outre, si le format de données est CF_DSPMETAFILEPICT ou CF_METAFILEPICT, le serveur doit également appeler DeleteMetaFile avec le handle de métafichier incorporé. Ces deux formats ont un niveau supplémentaire d’indirection ; Autrement dit, une application doit verrouiller l’objet pour obtenir un pointeur vers un handle, puis verrouiller ce handle pour obtenir un pointeur vers une structure METAFILEPICT , puis appeler DeleteMetaFile avec le handle du membre hMF de la structure METAFILEPICT .

Pour libérer l’objet, le serveur doit appeler la fonction FreeDDElParam .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Dde.h (inclure Windows.h)

Voir aussi

Référence

DDEPOKE

FreeDDElParam

GlobalAddAtom

METAFILEPICT

PackDDElParam

PostMessage

ReuseDDElParam

SendMessage

UnpackDDElParam

WM_DDE_ACK

Conceptuel

À propos de l’échange dynamique de données