Metodo ICLRDebugManager::BeginConnection
Stabilisce una nuova connessione tra l'host e il debugger per associare un elenco di attività a un identificatore e un nome descrittivo.
Sintassi
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t* szConnectionName
);
Parametri
dwConnectionId
[in] Identificatore da associare all'elenco di attività CLR (Common Language Runtime).
szConnectionName
[in] Nome descrittivo da associare all'elenco di attività CLR.
Valore restituito
| HRESULT | Descrizione |
|---|---|
| S_OK | BeginConnection restituito correttamente. |
| HOST_E_CLRNOTAVAILABLE | ClR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata. |
| HOST_E_TIMEOUT | Timeout della chiamata. |
| HOST_E_NOT_OWNER | Il chiamante non possiede il blocco. |
| HOST_E_ABANDONED | Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso. |
| E_FAIL | Si è verificato un errore irreversibile sconosciuto. Dopo che un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | dwConnectionId è stato zero o BeginConnection è già stato chiamato usando questo dwConnectionId valore o szConnectionName è null. |
| E_OUTOFMEMORY | È possibile allocare memoria insufficiente per contenere l'elenco di attività associate a questa connessione. |
Commenti
ICLRDebugManager offre tre metodi, , BeginConnectionSetConnectionTasks e EndConnection, per associare elenchi di attività con identificatori e nomi descrittivi.
Importante
Questi tre metodi devono essere chiamati in un ordine specifico per ogni set di attività. BeginConnection viene chiamato prima per stabilire una nuova connessione. SetConnectionTasks viene chiamato accanto per fornire il set di attività da associare a tale connessione. EndConnection viene chiamato ultimo per rimuovere l'associazione tra l'elenco attività e l'identificatore e il nome descrittivo. Tuttavia, le chiamate per connessioni diverse possono essere annidate.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: Incluso come risorsa in MSCorEE.dll
Versioni di .NET Framework: Disponibile da 2.0
