IRunnableObject::IsRunning
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método determina se um objeto está atualmente na execução estado.
Syntax
BOOL IsRunning();
Parameters
Nenhum.
Return Value
- TRUE
O objeto está na execução estado.
- FALSE
O objeto não está na execução estado.
Remarks
Um aplicativo contêiner poderia chamar IRunnableObject::IsRunning Quando ele precisa saber se o servidor é imediatamente disponível.
Para implementação de um contêiner de exemplo, o IOleItemContainer::GetObject método seria retornará um erro se o servidor não for execução e o bindspeed parâmetro especifica BINDSPEED_IMMEDIATE.
Um manipulador objeto poderia chamar IRunnableObject::IsRunning Quando ele quer evitar conflitos com uma execução servidor ou quando a execução servidor tenha atualizado mais informações.
De exemplo, implementação de um manipulador de IOleObject::GetExtent Seria delegado para o servidor objeto se ele for execução, como informações de servidor podem ser mais atual na armazenar em cache do manipulador.
OleIsRunning é um função de ajuda que repackages convenientemente a funcionalidade oferecida por IRunnableObject::IsRunning.
Com a versão de OLE 2.01, a implementação de OleIsRunning foi alterado para que ele chama Falha de QueryInterface, solicita IRunnableObjecte em seguida, chama IRunnableObject::IsRunning. Em outras palavras, você pode usar a interface e a função de ajuda de forma intercambiável.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requirements
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |