ICLRDebugManager::EndConnection-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Entfernt die Zuordnung zwischen einer Liste von Aufgaben, einem Bezeichner und einem Anzeigenamen.

HRESULT EndConnection (
    [in] CONNID dwConnectionId
);

Parameter

dwConnectionId
[in] Der hostspezifische Bezeichner für die Verbindung und die zugeordnete Liste von CLR-Aufgaben (Common Language Runtime).

Rückgabewert

HRESULT	Beschreibung
S_OK	EndConnection kehrte erfolgreich zurück.
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. 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 nie mit dwConnectionId aufgerufen, oder dwConnectionId war 0 (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 neue Verbindung herzustellen. SetConnectionTasks wird als Nächstes aufgerufen, um die Gruppe von Aufgaben bereitzustellen, die der Verbindung zugeordnet werden sollen. EndConnection wird zuletzt aufgerufen, um die Zuordnung zwischen der Aufgabenliste, dem Bezeichner und dem Anzeigenamen zu entfernen. Aufrufe für verschiedene 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 neue Verbindung herzustellen. SetConnectionTasks wird als Nächstes aufgerufen, um die Gruppe von Aufgaben bereitzustellen, die der Verbindung zugeordnet werden sollen. EndConnection wird zuletzt aufgerufen, um die Zuordnung zwischen der Aufgabenliste, dem Bezeichner und dem Anzeigenamen zu entfernen. Aufrufe für verschiedene Verbindungen können jedoch verschachtelt werden.