Método ICLRDebugManager::SetConnectionTasks

Artigo
08/25/2010

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ífico para a conexão ao qual associar o ppCLRTask matriz.
dwCount
[in] O número de membros de ppCLRTask. Esse número deve ser maior que zero.
ppCLRTask
[in] Uma matriz de ICLRTask ponteiros para associar com a conexão identificada por id. Essa matriz deve conter pelo menos um membro.

Valor de retorno

HRESULT	Descrição
S_OK	SetConnectionTasks retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Após um método retornar E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	BeginConnection não tiver sido chamado usar esse valor de id, ou dwCount ou id é zero ou um dos elementos de ppCLRTask é nulo.

Comentários

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

Observação importante:
Esses três métodos devem ser chamados em uma ordem específica para cada conjunto de tarefas. BeginConnection é chamado pela primeira vez para estabelecer uma nova conexão. SetConnectionTasks é chamado a seguir 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 nome.However amigável, chama para diferentes conexões podem ser aninhados.

Esses três métodos devem ser chamados em uma ordem específica para cada conjunto de tarefas. BeginConnection é chamado pela primeira vez para estabelecer uma nova conexão. SetConnectionTasks é chamado a seguir 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 nome.However amigável, chama para diferentes conexões podem ser aninhados.