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.
| Código de retorno | Descrição |
|---|---|
|
A interface representada por riid não é compatível com o objeto . O parâmetro ppvObj é definido como NULL. |
|
Memória insuficiente para a operação. |
|
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) |