Metodo IOleCache::InitCache (oleidl.h)

Riempie la cache in base alle esigenze usando i dati forniti dall'oggetto dati specificato.

Sintassi

HRESULT InitCache(
  [in] IDataObject *pDataObject
);

Parametri

[in] pDataObject

Puntatore all'interfaccia IDataObject nell'oggetto dati da cui deve essere inizializzata la cache.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_INVALIDARG	Il puntatore all'interfaccia IDataObject non è valido.
E_OUTOFMEMORY	Memoria insufficiente disponibile per l'operazione.
OLE_E_NOTRUNNING	La cache non è in esecuzione.
CACHE_E_NOCACHE_UPDATED	Nessuna delle cache è stata aggiornata.
CACHE_S_SOMECACHES_NOTUPDATED	Sono state aggiornate solo alcune delle cache esistenti.

Commenti

InitCache viene in genere usato durante la creazione di un oggetto da un'operazione di trascinamento della selezione o da un'operazione incolla negli Appunti. Riempie la cache in base alle esigenze con i dati di presentazione di tutti i formati di dati forniti dall'oggetto dati fornito negli Appunti o nell'operazione di trascinamento. Le funzioni helper come OleCreateFromData o OleCreateLinkFromData chiamano questo metodo quando necessario. Se un contenitore non usa queste funzioni helper per creare oggetti documento composti, può usare IOleCache::Cache per configurare le voci della cache che vengono quindi compilate da InitCache.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h

Vedi anche

IOleCache

IOleCache::Cache