Método ICLRDebugManager::BeginConnection

Artigo
08/25/2010

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

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

Parâmetros

dwConnectionId
[in] Um identificador para associar a lista de tarefas comuns de tempo de execução (CLR) do linguagem.
szConnectionName
[in] Um nome amigável para associar a lista de tarefas do CLR.

Valor de retorno

HRESULT	Descrição
S_OK	BeginConnection retornado com êxito.
HOST_E_CLRNOTAVAILABLE	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	dwConnectionId era zero, ou BeginConnection já foi chamado usando essa dwConnectionId valor, ou szConnectionName era nulo.
E_OUTOFMEMORY	Memória insuficiente poderia ser alocada para armazenar a lista de tarefas associados a esta conexão.

Comentários

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

Observação importante:
Esses três métodos devem ser chamados uma determinada order 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 uma determinada order 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.