IHostSecurityContext::Capture-Methode
Aktualisiert: November 2007
Ruft einen Klon der IHostSecurityContext-Instanz ab, die von einem Aufruf von IHostSecurityManager::GetSecurityContext zurückgegeben wurde.
HRESULT Capture (
[out] IHostSecurityContext** ppClonedContext
);
Parameter
- ppClonedContext
[out] Ein Zeiger auf die Adresse eines Klons des IHostSecurityContext-Objekts, das aufgezeichnet werden soll.
Rückgabewert
HRESULT |
Beschreibung |
|---|---|
S_OK |
Capture kehrte erfolgreich zurück. |
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
Der von Capture zurückgegebene Schnittstellenzeiger ist ein Klon des erfassten Kontexts. Wenn diese Informationen über einen asynchronen Codepunkt verschoben werden, wird dessen Lebensdauer von der des Zeigers getrennt wird, für den der Aufruf durchgeführt wurde. Der ursprüngliche Zeiger kann daher freigegeben werden.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: MSCorEE.idl
Bibliothek: als Ressource in MSCorEE.dll enthalten
.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0