Método de ICLRDebugManager::EndConnection

Artigo
08/08/2011

Remove a associação entre uma lista de tarefas e um identificador e um nome amigável.

HRESULT EndConnection (
    [in] CONNID dwConnectionId
);

Parâmetros

dwConnectionId
[in] O identificador de host específicos para a conexão e a lista de tarefas comuns de runtime (CLR) de idioma associada.

Valor de retorno

HRESULT	Descrição
S_OK	EndConnectionretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O 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 nunca foi chamado com dwConnectionId, ou dwConnectionId era zero.

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.