Metodo IRunnableObject::IsRunning (objidl.h)

Determina se un oggetto è attualmente in esecuzione.

Sintassi

BOOL IsRunning();

Valore restituito

Se l'oggetto si trova nello stato in esecuzione, il valore restituito è TRUE. In caso contrario, è FALSE.

Commenti

Un'applicazione contenitore può chiamare IRunnableObject::IsRunning quando deve sapere se il server è immediatamente disponibile. Ad esempio, l'implementazione di un contenitore del metodo IOleItemContainer::GetObject restituirà un errore se il server non è in esecuzione e il parametro bindspeed specifica BINDSPEED_IMMEDIATE.

Un gestore di oggetti può chiamare IRunnableObject::IsRunning quando vuole evitare conflitti con un server in esecuzione o quando il server in esecuzione potrebbe avere informazioni più aggiornate. Ad esempio, l'implementazione di IOleObject::GetExtent di un gestore delega al server oggetti se è in esecuzione, perché le informazioni del server potrebbero essere più correnti di quelle nella cache del gestore.

OleIsRunning è una funzione helper che riconfeziona facilmente le funzionalità offerte da IRunnableObject::IsRunning. Con il rilascio di OLE 2.01, l'implementazione di OleIsRunning è stata modificata in modo che chiami QueryInterface, richieda IRunnableObject e quindi chiami IRunnableObject::IsRunning. In altre parole, è possibile usare l'interfaccia e la funzione helper in modo intercambiabile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objidl.h

Vedi anche

IRunnableObject

OleIsRunning