ICLRDebugManager::SetConnectionTasks-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Ordnet einer List von ICLRTask-Instanzen einen Bezeichner und einen angezeigten Namen zu.

HRESULT SetConnectionTasks (
    [in] CONNID id,
    [in] DWORD dwCount,
    [in, size_is(dwCount)] ICLRTask **ppCLRTask
);

Parameter

id
[in] Der hostspezifische Bezeichner für die Verbindung, die dem ppCLRTask-Array zugeordnet werden soll.
dwCount
[in] Die Anzahl der Member von ppCLRTask. Diese Zahl muss größer als 0 (null) sein.
ppCLRTask
[in] Ein Array von ICLRTask-Zeigern, das der Verbindung zugeordnet werden soll, die von id angegeben wird. 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 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. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_INVALIDARG	BeginConnection wurde nicht mithilfe dieses Werts von id aufgerufen, oder dwCount oder id ist 0 (null), oder eines der Elemente von ppCLRTask ist NULL.

Hinweise

ICLRDebugManager stellt drei Methoden zum Zuordnen von Aufgabenlisten zu Bezeichnern und Anzeigenamen bereit: BeginConnection, SetConnectionTasks und EndConnection.

Wichtiger Hinweis:
Diese drei Methoden müssen für jede Gruppe von Aufgaben in einer bestimmten Reihenfolge aufgerufen werden. BeginConnection wird zuerst aufgerufen, um eine neu Verbindung herzustellen. SetConnectionTasks wird als Nächstes aufgerufen, um die Gruppe von Aufgaben bereitzustellen, die der Verbindung zugeordnet werden soll. EndConnection wird zuletzt aufgerufen, um die Zuordnung zwischen der Aufgabenliste, dem Bezeichner und dem Anzeigenamen zu entfernen. Aufrufe für verschiedenen Verbindungen können jedoch verschachtelt werden.

Diese drei Methoden müssen für jede Gruppe von Aufgaben in einer bestimmten Reihenfolge aufgerufen werden. BeginConnection wird zuerst aufgerufen, um eine neu Verbindung herzustellen. SetConnectionTasks wird als Nächstes aufgerufen, um die Gruppe von Aufgaben bereitzustellen, die der Verbindung zugeordnet werden soll. EndConnection wird zuletzt aufgerufen, um die Zuordnung zwischen der Aufgabenliste, dem Bezeichner und dem Anzeigenamen zu entfernen. Aufrufe für verschiedenen Verbindungen können jedoch verschachtelt werden.