ICLRTask::SetTaskIdentifier-Methode
Weist die Common Language Runtime (CLR) an, den angegebenen Bezeichnerwert der Aufgabe zuzuordnen, die durch die aktuelle ICLRTask-Instanz dargestellt wird.
Syntax
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Parameter
Asked
[in] Der eindeutige Bezeichner für die Common Language Runtime, der der durch die aktuelle ICLRTask-Instanz dargestellten Aufgabe zugeordnet werden soll.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | SetTaskIdentifier wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die 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
Der Host kann einen Bezeichner einer Aufgabe zuordnen, um die CLR und den Host in eine Debugumgebung zu integrieren. Der Bezeichner hat keine Bedeutung für die CLR. Die CLR übergibt ihn an eine Debuggeranwendung. Der Debugger kann diesen Bezeichner verwenden, um eine CLR-Aufrufliste einer Hostaufrufliste zuzuordnen und so zu ermöglichen, dass ihre jeweiligen Ablaufverfolgungsinformationen bei der Anzeige auf der Benutzeroberfläche des Debuggers vereinheitlicht werden.
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.
