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 |
|---|---|
|
Um dos argumentos não é válido. |
|
Ocorreu um erro inesperado. |
|
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 |