CWnd::OnCopyData

Cette fonction membre est appelée par l'infrastructure pour copier des données d'une application à une autre.

afx_msg BOOL OnCopyData(
   CWnd* pWnd,
   COPYDATASTRUCT* pCopyDataStruct 
);

Paramètres

  • pWnd
    Un pointeur vers un objet de CWnd qui envoie les données.

  • pCopyDataStruct
    Un pointeur vers une structure de COPYDATASTRUCT qui contient les données qui sont envoyées.

Valeur de retour

Retourne TRUE si l'application de réception accepte correctement les données.Sinon, retourne FALSE.

Notes

Les données qui sont passées ne doivent pas contenir des pointeurs ou d'autres références aux objets non exécutables à l'application réception des données.

Lorsque les données sont copiées, elles ne doivent pas être modifiées par un autre thread du processus expéditeur.

L'application de réception doit tenir compte des données en lecture seule.La structure pointée sur par le paramètre pCopyDataStruct est uniquement valide pendant la migration des données ; toutefois, l'application de réception ne doit pas libérer la mémoire associée à la structure.

Si l'application de réception a besoin d'accéder aux données après cette fonction, elle doit copier les données reçues dans une mémoire tampon locale.

[!REMARQUE]

Cette fonction membre est appelée par l'infrastructure pour permettre à votre application de gérer un message de fenêtre.Les paramètres sont passés à la fonction reflètent les paramètres acceptés par l'infrastructure lorsque le message a été accepté.Si vous appelez l'implémentation de la classe de base de cette fonction, cette implémentation utilise les paramètres initialement passés avec le message et non les paramètres que vous fournissez à la fonction.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

WM_COPYDATA