ICLRTask::SetTaskIdentifier-Methode
Weist die Common Language Runtime (CLR) an, den angegebenen Bezeichnerwert der Aufgabe zuzuordnen, die durch die aktuelle ICLRTask-Instanz dargestellt wird.
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Parameter
- Asked
[in] Der eindeutige Bezeichner für die Common Language Runtime, der der von der ICLRTask-Instanz dargestellten Aufgabe zugeordnet werden soll.
Rückgabewert
HRESULT |
Beschreibungen |
---|---|
S_OK |
SetTaskIdentifier erfolgreich zurückgegeben. |
HOST_E_CLRNOTAVAILABLE |
Die 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 Host kann einer Aufgabe einen Bezeichner zuordnen, um die Integration der CLR und des Hosts in eine Debugumgebung zu unterstützen. Der Bezeichner hat keine Bedeutung für die CLR. Die CLR übergibt ihn an eine Debuggeranwendung. Mithilfe des Bezeichners kann der Debugger eine CLR-Aufrufliste einer Host-Aufrufliste zuordnen. Dadurch ist es möglich, die jeweiligen Ablaufverfolgungsinformationen zu vereinheitlichen, wenn diese auf der Benutzeroberfläche des Debuggers angezeigt werden.
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