Método de ICLRDebugManager::BeginConnection

Artigo
08/08/2011

Estabelece uma nova conexão entre o host e o depurador para associar a uma lista de tarefas um identificador e um nome amigável.

HRESULT BeginConnection (
    [in] CONNID dwConnectionId,
    [in, string] wchar_t* szConnectionName
);

Parâmetros

dwConnectionId
[in] Um identificador para associar a lista de tarefas comuns de runtime (CLR) de idioma.
szConnectionName
[in] Um nome amigável para associar a lista de tarefas do CLR.

Valor de retorno

HRESULT	Descrição
S_OK	BeginConnectionretornado 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	dwConnectionIdera zero, ou BeginConnection já foi chamado usando essa dwConnectionId valor, ou szConnectionName era nulo.
E_OUTOFMEMORY	Não há memória suficiente poderia ser alocada para armazenar a lista de tarefas associadas a esta conexão.

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.