Método IOleCacheControl::OnRun (oleidl.h)
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 |
|---|---|
|
Uno de los argumentos no es válido. |
|
Se produjo un error inesperado. |
|
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 |