Metodo ICLRDebugManager::BeginConnection

Articolo
08/11/2011

Stabilisce una nuova connessione tra l'host e il debugger per associare un elenco di attività a un identificatore e a un nome descrittivo.

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

Parametri

dwConnectionId
[in] Identificatore da associare all'elenco di attività di Common Language Runtime (CLR).
szConnectionName
[in] Nome descrittivo da associare all'elenco di attività di CLR.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	BeginConnection ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	dwConnectionId è zero o BeginConnection è già stato chiamato utilizzando questo valore dwConnectionId oppure szConnectionName è null.
E_OUTOFMEMORY	Impossibile allocare memoria sufficiente a contenere l'elenco di attività associate a questa connessione.

Note

ICLRDebugManager fornisce tre metodi, BeginConnection, SetConnectionTasksed EndConnection, per l'associazione di elenchi di attività a identificatori e nomi descrittivi.

Importante
Questi tre metodi devono essere chiamati in un ordine specifico per ogni set di attività.Per primo viene chiamato BeginConnection per stabilire una nuova connessione.Quindi viene chiamato SetConnectionTasks per fornire il set di attività da associare alla connessione.Infine viene chiamato EndConnection per rimuovere l'associazione tra l'elenco di attività e l'identificatore e il nome descrittivo. Tuttavia, le chiamate alle diverse connessioni possono essere annidate.

Questi tre metodi devono essere chiamati in un ordine specifico per ogni set di attività.Per primo viene chiamato BeginConnection per stabilire una nuova connessione.Quindi viene chiamato SetConnectionTasks per fornire il set di attività da associare alla connessione.Infine viene chiamato EndConnection per rimuovere l'associazione tra l'elenco di attività e l'identificatore e il nome descrittivo. Tuttavia, le chiamate alle diverse connessioni possono essere annidate.