Freigeben über


ICLRSyncManager::GetRWLockOwnerNext-Methode

Ruft die nächste IHostTask-Instanz ab, die für die aktuelle Reader-Writer-Sperre blockiert ist.

Syntax

HRESULT GetRWLockOwnerNext (  
    [in] SIZE_T       Iterator,  
    [out] IHostTask  *ppOwnerHostTask  
);  

Parameter

Iterator
[in] Der Iterator, der mithilfe eines Aufrufs von CreateRWLockOwnerIterator erstellt wurde.

ppOwnerHostTask
[out] Ein Zeiger auf den nächsten IHostTask, der auf die Sperre wartet, oder NULL, wenn keine Aufgabe wartet.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK GetRWLockOwnerNext wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT Timeout des Aufrufs.
HOST_E_NOT_OWNER Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Wenn ppOwnerHostTask auf NULL festgelegt ist, wurde die Iteration beendet und der Host sollte die DeleteRWLockOwnerIterator-Methode aufrufen.

Hinweis

Die CLR ruft AddRef auf den IHostTask auf, auf den ppOwnerHostTask zeigt, um zu verhindern, dass diese Aufgabe beendet wird, während der Host den Zeiger hält. Der Host muss Release aufrufen, um die Verweisanzahl zu verringern, wenn er abgeschlossen ist.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch