Método ICLRDebugManager::BeginConnection
Estabelece uma nova conexão entre o host e o depurador para associar uma lista de tarefas a um identificador e a um nome amigável.
Sintaxe
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t* szConnectionName
);
Parâmetros
dwConnectionId
[in] Um identificador a ser associado à lista de tarefas do CLR (Common Language Runtime).
szConnectionName
[in] Um nome amigável a ser associado à lista de tarefas do CLR.
Valor Retornado
| 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 no qual não pode executar código gerenciado ou processar a chamada com êxito. |
| HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
| HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
| E_FAIL | Uma falha catastrófica desconhecida ocorreu. Depois que um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | dwConnectionId era zero ou BeginConnection já era chamado usando esse valor dwConnectionId ou szConnectionName era nulo. |
| E_OUTOFMEMORY | Não foi possível alocar memória suficiente para manter a lista de tarefas associadas a essa conexão. |
Comentários
ICLRDebugManager fornece três métodos, BeginConnection, SetConnectionTasks e EndConnection, para associar listas de tarefas a identificadores e nomes amigáveis.
Importante
Esses três métodos precisam ser chamados em uma ordem específica para cada conjunto de tarefas. BeginConnection é chamado primeiro para estabelecer uma nova conexão. SetConnectionTasks é chamado em seguida para fornecer o conjunto de tarefas que será associado a essa conexão. EndConnection é chamado por último para remover a associação entre a lista de tarefas e o identificador e o nome amigável. No entanto, as chamadas a conexões diferentes poderão ser aninhadas.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0
