Função CreateDataCache (objbase.h)

  • Artigo

Recupera um ponteiro para uma nova instância de uma implementação fornecida por OLE de um cache de dados.

Sintaxe

HRESULT CreateDataCache(
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFCLSID  rclsid,
  [in]  REFIID    iid,
  [out] LPVOID    *ppv
);

Parâmetros

[in] pUnkOuter

Se o cache for criado como parte de uma agregação, ponteiro para o controle IUnknown da agregação. Caso contrário, o parâmetro deverá ser NULL.

[in] rclsid

CLSID usado para gerar rótulos de ícone. Normalmente, esse valor é CLSID_NULL.

[in] iid

Referência ao identificador da interface que o chamador deseja usar para se comunicar com o cache. Esse valor normalmente é IID_IOleCache (definido nos cabeçalhos OLE para ser igual ao identificador de interface para IOleCache).

[out] ppv

Endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, *ppvObj contém o ponteiro de interface solicitado para o objeto de cache fornecido.

Valor retornado

Essa função retorna S_OK com êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
E_NOINTERFACE
 A interface representada por riid não é compatível com o objeto . O parâmetro ppvObj é definido como NULL.
E_OUTOFMEMORY
 Memória insuficiente para a operação.
E_INVALIDARG
Um ou mais parâmetros são inválidos.

Comentários

O objeto de cache criado por CreateDataCache dá suporte às interfaces IOleCache, IOleCache2 e IOleCacheControl para controlar o cache. Ele também dá suporte às interfaces IPersistStorage, IDataObject (sem coletores de aviso), IViewObject e IViewObject2 .

Requisitos

   
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 objbase.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-5 (introduzido no Windows 10, versão 10.0.15063)

Confira também

IOleCache

IOleCache2

IOleCacheControl