Condividi tramite


Metodo ICLRDebugManager::SetConnectionTasks

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

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

Parametri

  • id
    [in] Identificatore specifico dell'host per la connessione alla quale deve essere associata la matrice ppCLRTask.

  • dwCount
    [in] Numero di membri di ppCLRTask. Deve essere maggiore di zero.

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

Valore restituito

HRESULT

Oggetto di descrizione

S_OK

SetConnectionTasks 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 successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

E_INVALIDARG

Il metodo BeginConnection non è stato chiamato utilizzando questo valore di id o di dwCount oppure il parametro id è zero o uno degli elementi di ppCLRTask è null.

Note

L'interfaccia ICLRDebugManager fornisce tre metodi per l'associazione di elenchi di attività a identificatori e nomi descrittivi: BeginConnection, SetConnectionTasks ed EndConnection.

Nota importanteImportante

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.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Interfaccia ICLRControl

Interfaccia ICLRDebugManager

Metodo ICLRDebugManager::BeginConnection

Metodo ICLRDebugManager::EndConnection

Interfaccia IHostControl