Método IRunnableObject::IsRunning (objidl.h)

  • Artículo

Determina si un objeto está actualmente en estado de ejecución.

Sintaxis

BOOL IsRunning();

Valor devuelto

Si el objeto está en estado de ejecución, el valor devuelto es TRUE. De lo contrario, es FALSE.

Comentarios

Una aplicación contenedora podría llamar a IRunnableObject::IsRunning cuando necesite saber si el servidor está disponible inmediatamente. Por ejemplo, la implementación de un contenedor del método IOleItemContainer::GetObject devolvería un error si el servidor no se está ejecutando y el parámetro bindspeed especifica BINDSPEED_IMMEDIATE.

Un controlador de objetos podría llamar a IRunnableObject::IsRunning cuando quiere evitar conflictos con un servidor en ejecución o cuando el servidor en ejecución podría tener información más actualizada. Por ejemplo, la implementación de un controlador de IOleObject::GetExtent delegaría en el servidor de objetos si se está ejecutando, ya que la información del servidor podría ser más actual que la de la caché del controlador.

OleIsRunning es una función auxiliar que vuelve a empaquetar convenientemente la funcionalidad que ofrece IRunnableObject::IsRunning. Con el lanzamiento de OLE 2.01, se cambió la implementación de OleIsRunning para que llame a QueryInterface, solicite IRunnableObject y, a continuación, llame a IRunnableObject::IsRunning. En otras palabras, puede usar la interfaz y la función auxiliar indistintamente.

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 objidl.h

Consulte también

IRunnableObject

OleIsRunning