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

Preenche o cache conforme necessário usando os dados fornecidos pelo objeto de dados especificado.

Sintaxe

HRESULT InitCache(
  [in] IDataObject *pDataObject
);

Parâmetros

[in] pDataObject

Um ponteiro para a interface IDataObject no objeto de dados do qual o cache deve ser inicializado.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_INVALIDARG	O ponteiro para a interface IDataObject é inválido.
E_OUTOFMEMORY	Memória insuficiente disponível para a operação.
OLE_E_NOTRUNNING	O cache não está em execução.
CACHE_E_NOCACHE_UPDATED	Nenhum dos caches foi atualizado.
CACHE_S_SOMECACHES_NOTUPDATED	Apenas alguns dos caches existentes foram atualizados.

Comentários

O InitCache geralmente é usado ao criar um objeto de uma operação de arrastar e soltar ou de uma operação de colagem de área de transferência. Ele preenche o cache conforme necessário com dados de apresentação de todos os formatos de dados fornecidos pelo objeto de dados fornecido na área de transferência ou na operação de arrastar e soltar. Funções auxiliares como OleCreateFromData ou OleCreateLinkFromData chamam esse método quando necessário. Se um contêiner não usar essas funções auxiliares para criar objetos de documento composto, ele poderá usar IOleCache::Cache para configurar as entradas de cache que são preenchidas pelo InitCache.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h

Confira também

IOleCache

IOleCache::Cache