IOleObject::GetClipboardData, méthode (oleidl.h)
Récupère un objet de données contenant le contenu actuel de l’objet incorporé sur lequel cette méthode est appelée. À l’aide du pointeur vers cet objet de données, il est possible de créer un objet incorporé avec les mêmes données que l’objet d’origine.
HRESULT GetClipboardData(
[in] DWORD dwReserved,
[out] IDataObject **ppDataObject
);
[in] dwReserved
Ce paramètre est réservé et doit être égal à zéro.
[out] ppDataObject
Adresse de la variable pointeur IDataObject qui reçoit le pointeur d’interface vers l’objet de données. Si une erreur se produit, ppDataObject doit être défini sur NULL. Chaque fois qu’un objet reçoit un appel à IOleObject::GetClipboardData, il doit augmenter le nombre de références sur ppDataObject. Il incombe à l’appelant d’appeler Release lorsqu’il est terminé avec ppDataObject.
Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.
Code de retour | Description |
---|---|
|
GetClipboardData n’est pas pris en charge. |
|
L’objet n’est pas en cours d’exécution. |
Vous pouvez utiliser la méthode IOleObject::GetClipboardData pour convertir un objet lié en objet incorporé, auquel cas l’application conteneur appelle IOleObject::GetClipboardData , puis transmet les données reçues à OleCreateFromData. Cette méthode retourne un pointeur vers un objet de données identique à ce qui aurait été passé au Presse-papiers par une opération de copie standard.
Si vous souhaitez une instantané stable du contenu actuel d’un objet incorporé, appelez IOleObject::GetClipboardData. Si les données changent, vous devez appeler à nouveau la fonction pour obtenir une instantané mise à jour. Si vous souhaitez que l’appelant soit informé des modifications apportées aux données, appelez QueryInterface, puis appelez IDataObject::D Advise. Si vous implémentez cette fonction, vous devez retourner un pointeur IDataObject pour un objet dont les données ne changeront pas.Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | oleidl.h |