Share via

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

  • Artículo

Notifica a la memoria caché que el objeto de origen de datos ha entrado en estado de ejecución para que el objeto de caché pueda establecer receptores de asesoramiento según sea necesario.

Sintaxis

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

Parámetros

[in] pDataObject

Puntero a la interfaz IDataObject del objeto que entra en estado de ejecución.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
E_INVALIDARG
 Uno de los argumentos no es válido.
E_UNEXPECTED
 Se produjo un error inesperado.
E_OUTOFMEMORY
 No hay suficiente memoria disponible para esta operación.

Comentarios

Cuando se llama a OnRun , la memoria caché configura las conexiones de asesoramiento según sea necesario con el objeto de datos de origen para que pueda recibir notificaciones. La conexión de aviso creada entre el objeto en ejecución y la memoria caché se destruye cuando se llama a IOleCacheControl::OnStop .

Algunos controladores de objetos o servidores en proceso pueden usar la memoria caché pasivamente y no llamar a OnRun. Estas aplicaciones deben llamar a IOleCache2::UpdateCache, IOleCache::InitCache o IOleCache::SetData para rellenar la memoria caché cuando sea necesario para asegurarse de que la memoria caché se actualice.

OnRun no agrega un recuento de referencias en el puntero a IDataObject pasado en pDataObject. Dado que es responsabilidad del autor de la llamada de OleRun asegurarse de que la duración del puntero pDataObject dura hasta que se llama a OnStop , el autor de la llamada debe mantener un puntero a IDataObject en el objeto de datos de interés.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleidl.h

Consulte también

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop