Método IOleCacheControl::OnRun (oleidl.h)

Notifica o cache de que o objeto de fonte de dados entrou no estado em execução para que o objeto de cache possa estabelecer coletores de consultoria conforme necessário.

Sintaxe

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

Parâmetros

[in] pDataObject

Um ponteiro para a interface IDataObject no objeto que está entrando no estado em execução.

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	Um dos argumentos não é válido.
E_UNEXPECTED	Ocorreu um erro inesperado.
E_OUTOFMEMORY	Memória insuficiente disponível para esta operação.

Comentários

Quando OnRun é chamado, o cache configura conexões de consultoria conforme necessário com o objeto de dados de origem para que ele possa receber notificações. A conexão de consultoria criada entre o objeto em execução e o cache é destruída quando IOleCacheControl::OnStop é chamado.

Alguns manipuladores de objetos ou servidores em processo podem usar o cache passivamente e não chamar OnRun. Esses aplicativos devem chamar IOleCache2::UpdateCache, IOleCache::InitCache ou IOleCache::SetData para preencher o cache quando necessário para garantir que o cache seja atualizado.

OnRun não adiciona uma contagem de referência no ponteiro para IDataObject passado em pDataObject. Como é responsabilidade do chamador de OleRun garantir que o tempo de vida do ponteiro pDataObject dure até onStop ser chamado, o chamador deve estar segurando um ponteiro para IDataObject no objeto de dados de interesse.

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

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop