ICLRDebugManager::SetConnectionTasks-Methode
Ordnet eine Liste von ICLRTask-Instanzen einem Bezeichner und einem Anzeigenamen zu.
Syntax
HRESULT SetConnectionTasks (
[in] CONNID id,
[in] DWORD dwCount,
[in, size_is(dwCount)] ICLRTask **ppCLRTask
);
Parameter
id
[in] Der hostspezifische Bezeichner für die Verbindung, der das ppCLRTask-Array zugeordnet werden soll.
dwCount
[in] Die Anzahl der Member von ppCLRTask. Dieser Wert muss größer null sein.
ppCLRTask
[in] Ein Array von ICLRTask-Zeigern, die der durch id identifizierten Verbindung zugeordnet werden sollen. Dieses Array muss mindestens einen Member enthalten.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | SetConnectionTasks 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. |
| E_INVALIDARG | BeginConnection wurde nicht mit diesem Wert von id aufgerufen, dwCount oder id ist null, oder eines der Elemente von ppCLRTask ist NULL. |
Bemerkungen
ICLRDebugManager bietet drei Methoden (BeginConnection, SetConnectionTasks und EndConnection) zum Zuordnen von Aufgabenlisten zu Bezeichnern und Anzeigenamen.
Wichtig
Diese drei Methoden müssen für jede Gruppe von Aufgaben in einer bestimmten Reihenfolge aufgerufen werden. BeginConnection wird zuerst aufgerufen, um eine neue Verbindung herzustellen. SetConnectionTasks wird als Nächstes aufgerufen, um die Gruppe der Aufgaben bereitzustellen, die dieser Verbindung zugeordnet werden sollen. EndConnection wird zuletzt aufgerufen, um die Zuordnung zwischen der Aufgabenliste und dem Bezeichner und Anzeigenamen zu entfernen. Aufrufe für verschiedene Verbindungen können jedoch geschachtelt 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.
