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 |