Funzione OleLockRunning (ole2.h)

Blocca un oggetto già in esecuzione o lo sblocca dallo stato di esecuzione.

Sintassi

HRESULT OleLockRunning(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fLock,
  [in] BOOL      fLastUnlockCloses
);

Parametri

[in] pUnknown

Puntatore all'interfaccia IUnknown nell'oggetto , che la funzione usa per eseguire una query per un puntatore a IRunnableObject.

[in] fLock

TRUE blocca l'oggetto nello stato di esecuzione. FALSE sblocca l'oggetto dallo stato di esecuzione.

[in] fLastUnlockCloses

TRUE specifica che se la connessione rilasciata è l'ultimo blocco esterno sull'oggetto, l'oggetto deve chiudersi. FALSE specifica che l'oggetto deve rimanere aperto fino a quando non viene chiuso dall'utente o da un altro processo.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito Descrizione
E_OUTOFMEMORY
Memoria insufficiente per l'operazione.
E_INVALIDARG
Uno o più parametri non sono validi.
E_UNEXPECTED
Si è verificato un errore imprevisto.

Commenti

La funzione OleLockRunning salva i problemi di chiamata al metodo IRunnableObject::LockRunning . È possibile usare OleLockRunning e IRunnableObject::LockRunning in modo intercambiabile. Con il puntatore IUnknown passato con il parametro pUnknown , OleLockRunning esegue una query per un puntatore IRunnableObject . Se ha esito positivo, chiama IRunnableObject::LockRunning e restituisce i risultati della chiamata.

Per altre informazioni sull'uso di questa funzione, vedere IRunnableObject::LockRunning.

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 ole2.h
Libreria Ole32.lib
DLL Ole32.dll

Vedi anche

CoLockObjectExternal

IRunnableObject::LockRunning

OleNoteObjectVisible