Compartilhar via


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