Partager via


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

Remplit le cache en fonction des besoins à l’aide des données fournies par l’objet de données spécifié.

Syntaxe

HRESULT InitCache(
  [in] IDataObject *pDataObject
);

Paramètres

[in] pDataObject

Pointeur vers l’interface IDataObject sur l’objet de données à partir duquel le cache doit être initialisé.

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_INVALIDARG
Le pointeur vers l’interface IDataObject n’est pas valide.
E_OUTOFMEMORY
La mémoire disponible pour l’opération est insuffisante.
OLE_E_NOTRUNNING
Le cache n’est pas en cours d’exécution.
CACHE_E_NOCACHE_UPDATED
Aucun des caches n’a été mis à jour.
CACHE_S_SOMECACHES_NOTUPDATED
Seuls certains caches existants ont été mis à jour.

Remarques

InitCache est généralement utilisé lors de la création d’un objet à partir d’une opération de glisser-déplacer ou d’une opération de collage du Presse-papiers. Il remplit le cache selon les besoins avec les données de présentation de tous les formats de données fournis par l’objet de données fourni dans le Presse-papiers ou dans l’opération de glisser-déplacer. Les fonctions d’assistance telles que OleCreateFromData ou OleCreateLinkFromData appellent cette méthode si nécessaire. Si un conteneur n’utilise pas ces fonctions d’assistance pour créer des objets de document composés, il peut utiliser IOleCache ::Cache pour configurer les entrées de cache qui sont ensuite remplies par InitCache.

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