Metodo ICLRDebugManager::SetConnectionTasks

Articolo
05/10/2023

Associa un elenco di istanze ICLRTask a un identificatore e a un nome descrittivo.

Sintassi

HRESULT SetConnectionTasks (  
    [in] CONNID id,  
    [in] DWORD dwCount,  
    [in, size_is(dwCount)] ICLRTask **ppCLRTask  
);

Parametri

id
[in] Identificatore specifico dell'host per la connessione a cui associare la ppCLRTask matrice.

dwCount
[in] Numero di membri di ppCLRTask. Questo numero deve essere maggiore di zero.

ppCLRTask
[in] Matrice di ICLRTask puntatori da associare alla connessione identificata da id. Questa matrice deve contenere almeno un membro.

Valore restituito

HRESULT	Descrizione
S_OK	`SetConnectionTasks` restituito correttamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (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 durante l'attesa di un thread o di una fibra bloccata.
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	BeginConnection non è stato chiamato usando questo valore di `id`o `dwCountid` è zero oppure uno degli elementi di `ppCLRTask` è Null.

Commenti

ICLRDebugManager fornisce tre metodi, BeginConnection, SetConnectionTaskse 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 a fornire il set di attività da associare a tale connessione. EndConnection viene chiamato last 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 dalla versione 2.0

Condividi tramite