Freigeben über


IHostCrst::TryEnter-Methode

Versucht, in den durch die aktuelle IHostCrst-Instanz dargestellten kritischen Abschnitt einzutreten.

HRESULT TryEnter (
    [in]  DWORD  option,
    [out] BOOL   *pbSucceeded
);

Parameter

  • option
    [in] Einer der WAIT_OPTION-Werte. Er gibt an, welche Aktion der Host ausführen soll, wenn der Vorgang blockiert.

  • pbSucceeded
    [out] true, wenn ein Eintritt in den kritischen Abschnitt möglich ist, andernfalls false.

Rückgabewert

HRESULT

Beschreibungen

S_OK

TryEnter erfolgreich zurückgegeben.

HOST_E_CLRNOTAVAILABLE

Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.

HOST_E_TIMEOUT

Der Aufruf hat das Zeitlimit überschritten.

HOST_E_NOT_OWNER

Der Aufrufer ist nicht Besitzer der Sperre.

HOST_E_ABANDONED

Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.

E_FAIL

Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

TryEnter wird sofort zurückgegeben und gibt an, ob der aufrufende Thread in den kritischen Abschnitt eingetreten ist. Diese Methode spiegelt die Win32-TryEnterCriticalSection-Funktion.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICLRSyncManager-Schnittstelle

IHostCrst-Schnittstelle

IHostSyncManager-Schnittstelle