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