Freigeben über

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.

Siehe auch

  • Last updated on