Método de ICLRDebugManager::SetConnectionTasks

Artigo
08/08/2011

Associa uma lista de ICLRTask instâncias com um identificador e um nome amigável.

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

Parâmetros

id
[in] O identificador de host específicos para a conexão ao qual associar o ppCLRTask matriz.
dwCount
[in] O número de membros da ppCLRTask. Esse número deve ser maior que zero.
ppCLRTask
[in] Uma matriz de ICLRTask ponteiros para associar a conexão identificada por id. Esta matriz deve conter pelo menos um membro.

Valor de retorno

HRESULT	Descrição
S_OK	SetConnectionTasksretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Depois de um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	BeginConnection não foi chamado usando esse valor de id, ou dwCount ou id é zero, ou um dos elementos de ppCLRTask é null.

Comentários

ICLRDebugManager fornece três métodos, BeginConnection, SetConnectionTasks, e EndConnection, para associar listas de tarefas identificadores e nomes amigáveis.

Importante
Esses três métodos devem ser chamados em uma ordem específica para cada conjunto de tarefas.BeginConnectioné chamado primeiro estabelecer uma nova conexão.SetConnectionTaskspróxima é chamada para fornecer o conjunto de tarefas a ser associado essa conexão.EndConnectioné chamado pela última vez para remover a associação entre a lista de tarefas e o identificador e o nome amigável.No entanto, as chamadas para diferentes conexões podem ser aninhadas.

Esses três métodos devem ser chamados em uma ordem específica para cada conjunto de tarefas.BeginConnectioné chamado primeiro estabelecer uma nova conexão.SetConnectionTaskspróxima é chamada para fornecer o conjunto de tarefas a ser associado essa conexão.EndConnectioné chamado pela última vez para remover a associação entre a lista de tarefas e o identificador e o nome amigável.No entanto, as chamadas para diferentes conexões podem ser aninhadas.