IOleObject::GetClipboardData, méthode (oleidl.h)

Article
08/25/2023

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.

Syntaxe

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

Paramètres

[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.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_NOTIMPL	GetClipboardData n’est pas pris en charge.
OLE_E_NOTRUNNING	L’objet n’est pas en cours d’exécution.

Notes

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.

Remarques aux appelants

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.

Remarques aux implémenteurs

Si vous implémentez cette fonction, vous devez retourner un pointeur IDataObject pour un objet dont les données ne changeront pas.

Spécifications


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