ICLRDebugManager::BeginConnection-Methode

Artikel
06/05/2023

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

Syntax

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

Parameter

dwConnectionId
[in] Ein Bezeichner, der der Liste der CLR-Aufgaben (Common Language Runtime) zugeordnet wird.

szConnectionName
[in] Ein Anzeigename, der der Liste der CLR-Aufgaben zugeordnet wird.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`BeginConnection` wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die 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	`dwConnectionId` war null, oder `BeginConnection` wurde bereits mit diesem `dwConnectionId`-Wert aufgerufen, oder `szConnectionName` war NULL.
E_OUTOFMEMORY	Es konnte nicht genügend Arbeitsspeicher zugewiesen werden, um die Liste der mit dieser Verbindung verknüpften Aufgaben zu speichern.

Bemerkungen

ICLRDebugManager bietet drei Methoden (BeginConnection, SetConnectionTasks und EndConnection) zum Zuordnen von Aufgabenlisten mit Bezeichnern und Anzeigenamen.

Wichtig

Diese drei Methoden müssen für jede Gruppe von Aufgaben in einer bestimmten Reihenfolge aufgerufen werden. Zunächst wird BeginConnection 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.

Freigeben über