Metodo ICLRDebugManager::SetConnectionTasks

Articolo
08/11/2011

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.

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.