Método ICLRDebugManager::SetConnectionTasks
Associa uma lista de instâncias ICLRTask a um identificador e um nome amigável.
Sintaxe
HRESULT SetConnectionTasks (
[in] CONNID id,
[in] DWORD dwCount,
[in, size_is(dwCount)] ICLRTask **ppCLRTask
);
Parâmetros
id
[in] O identificador específico do host para a conexão com a qual associar a matriz ppCLRTask.
dwCount
[in] O número de membros de ppCLRTask. Esse número deve ser maior que zero.
ppCLRTask
[in] Uma matriz de ponteiros ICLRTask para associar à conexão identificada por id. Essa matriz deve conter pelo menos um membro.
Valor Retornado
| HRESULT | Descrição |
|---|---|
| S_OK | SetConnectionTasks retornado com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso. |
| HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
| HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
| E_FAIL | Uma falha catastrófica desconhecida ocorreu. Depois que um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | BeginConnection não foi chamado usando esse valor de id, ou dwCountid é zero, ou um dos elementos de ppCLRTask é nulo. |
Comentários
ICLRDebugManager fornece três métodos, BeginConnection, SetConnectionTasks e EndConnection, para associar as listas de tarefas com os identificadores e nomes amigáveis.
Importante
Esses três métodos precisam ser chamados em uma ordem específica para cada conjunto de tarefas. BeginConnection é chamado primeiro para estabelecer uma nova conexão. SetConnectionTasks é chamado em seguida para fornecer o conjunto de tarefas que será associado a essa conexão. EndConnection é chamado por último para remover a associação entre a lista de tarefas e o identificador e o nome amigável. No entanto, as chamadas a conexões diferentes poderão ser aninhadas.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0
