Função CreateDataCache (objbase.h)

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.

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

Confira também

IOleCache

IOleCache2

IOleCacheControl