Metodo ICLRSyncManager::CreateRWLockOwnerIterator

  • Articolo

Richiede che Common Language Runtime (CLR) crei un iteratore per l'host da usare per determinare il set di attività in attesa in un blocco reader-writer.

Sintassi

HRESULT CreateRWLockOwnerIterator (  
    [in]  SIZE_T    cookie,  
    [out] SIZE_T   *pIterator  
);

Parametri

cookie
[in] Cookie associato al blocco reader-writer desiderato.

pIterator
[out] Puntatore a un iteratore che può essere passato ai metodi GetRWLockOwnerNext e DeleteRWLockOwnerIterator .

Valore restituito

HRESULT Descrizione
S_OK CreateRWLockOwnerIterator restituito correttamente.
HOST_E_CLRNOTAVAILABLE ClR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION CreateRWLockOwnerIterator è stato chiamato su un thread attualmente in esecuzione codice gestito.

Commenti

Gli host in genere chiamano i metodi , DeleteRWLockOwnerIteratore GetRWLockOwnerNext durante il CreateRWLockOwnerIteratorrilevamento del deadlock. L'host è responsabile di garantire che il blocco reader-writer sia ancora valido, perché CLR non tenta di mantenere attivo il blocco reader-writer. Sono disponibili diverse strategie per l'host per garantire la validità del blocco:

  • L'host può bloccare le chiamate di rilascio sul blocco reader-writer ,ad esempio IHostSemaphore::ReleaseSemaphore, assicurandosi che questo blocco non causa deadlock.

  • L'host può bloccare l'uscita dall'attesa sull'oggetto evento associato al blocco reader-writer, assicurando di nuovo che questo blocco non causa deadlock.

Nota

CreateRWLockOwnerIterator deve essere chiamato solo nei thread che attualmente eseguono codice non gestito.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 2.0

Vedi anche