ICLRDebugManager::BeginConnection-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Stellt eine neue Verbindung zwischen dem Host und dem Debugger her, um einem Bezeichner und einem angezeigten Namen eine Liste von Aufgaben zuzuordnen.

HRESULT BeginConnection (
    [in] CONNID dwConnectionId,
    [in, string] wchar_t* szConnectionName
);

Parameter

dwConnectionId
[in] Ein Bezeichner, der der Liste von Common Language Runtime-Aufgaben (CLR) zugeordnet werden soll.
szConnectionName
[in] Ein angezeigter Name, der der Liste von CLR-Aufgaben zugeordnet werden soll.

Rückgabewert

HRESULT	Beschreibung
S_OK	BeginConnection wurde 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	Das Zeitlimit für den Aufruf wurde ü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	dwConnectionId war 0 (null), oder BeginConnection wurde bereits mit diesem dwConnectionId-Wert aufgerufen, oder szConnectionName war NULL.
E_OUTOFMEMORY	Es konnte nicht genügend Arbeitsspeicher für die Liste der Aufgaben reserviert werden, die dieser Verbindung zugeordnet sind.

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.