Méthode IOleCache ::SetData (oleidl.h)

Initialise le cache avec des données dans un format spécifié et sur un support spécifié.

Syntaxe

HRESULT SetData(
  [in] FORMATETC *pformatetc,
  [in] STGMEDIUM *pmedium,
  [in] BOOL      fRelease
);

Paramètres

[in] pformatetc

Pointeur vers une structure FORMATETC qui spécifie le format des données de présentation placées dans le cache.

[in] pmedium

Pointeur vers une structure STGMEDIUM qui spécifie le support de stockage qui contient les données de présentation.

[in] fRelease

Indique la propriété du support de stockage une fois la méthode terminée. Si fRelease a la valeur TRUE, le cache prend possession, ce qui libère le support lorsqu’il a fini de l’utiliser. Lorsque fRelease a la valeur FALSE, l’appelant conserve la propriété et est chargé de libérer le support. Le cache ne peut utiliser le support de stockage que pendant la durée de l’appel.

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
DV_E_LINDEX	La valeur n’est pas valide pour pformatetc-lindex>. Actuellement, seul -1 est pris en charge.
DV_E_FORMATETC	La structure FORMATETC n’est pas valide.
DV_E_TYMED	La valeur n’est pas valide pour pformatetc-tymed>.
DV_E_DVASPECT	La valeur n’est pas valide pour pformatetc-dwAspect>.
OLE_E_BLANK	Il existe un objet non initialisé.
DV_E_TARGETDEVICE	L’objet est statique et pformatetc-ptd> n’est pas NULL.
STG_E_MEDIUMFULL	Le support de stockage est plein.

Remarques

IOleCache ::SetData est généralement appelé lorsqu’un objet est créé à partir du Presse-papiers ou via une opération de glisser-déplacer, et incorporer des données sources est utilisé pour créer l’objet.

IOleCache ::SetData et IOleCache ::InitCache sont très similaires. Il existe deux différences main. La première différence est que tandis que IOleCache ::InitCache initialise le cache avec le format de présentation fourni par l’objet de données, IOleCache ::SetData l’initialise avec un format unique. Deuxièmement, la méthode IOleCache ::SetData ignore l’indicateur ADVF_NODATA tandis que IOleCache ::InitCache obéit à cet indicateur.

Un conteneur peut utiliser cette méthode pour conserver un seul aspect d’un objet, tel que l’aspect icône de l’objet.

Configuration requise

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]
Plateforme cible	Windows
En-tête	oleidl.h

Voir aussi

IOleCache

IOleCache ::Cache

IOleCache ::SetData