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

Determina se um objeto está atualmente no estado em execução.

Sintaxe

BOOL IsRunning();

Retornar valor

Se o objeto estiver no estado em execução, o valor retornado será TRUE. Caso contrário, será FALSE.

Comentários

Um aplicativo de contêiner pode chamar IRunnableObject::IsRunning quando precisar saber se o servidor está disponível imediatamente. Por exemplo, a implementação de um contêiner do método IOleItemContainer::GetObject retornará um erro se o servidor não estiver em execução e o parâmetro bindspeed especificar BINDSPEED_IMMEDIATE.

Um manipulador de objetos pode chamar IRunnableObject::IsRunning quando quiser evitar conflitos com um servidor em execução ou quando o servidor em execução pode ter informações mais atualizadas. Por exemplo, a implementação de um manipulador de IOleObject::GetExtent delegaria ao servidor de objetos se ele estiver em execução, pois as informações do servidor podem ser mais atuais do que as do cache do manipulador.

OleIsRunning é uma função auxiliar que reempacota convenientemente a funcionalidade oferecida por IRunnableObject::IsRunning. Com o lançamento do OLE 2.01, a implementação de OleIsRunning foi alterada para que ele chame QueryInterface, solicite IRunnableObject e, em seguida, chame IRunnableObject::IsRunning. Em outras palavras, você pode usar a interface e a função auxiliar de forma intercambiável.

Requisitos

Confira também

Irunnableobject

OleIsRunning