ICLRDebugManager::BeginConnection (Método)

Artículo
08/10/2011

Establece una nueva conexión entre el host y el depurador para asociar una lista de tareas a un identificador y un nombre descriptivo.

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

Parámetros

dwConnectionId
[in] Identificador que se va a asociar a la lista de tareas de Common Language Runtime (CLR).
szConnectionName
[in] Nombre descriptivo que se va a asociar a la lista de tareas de CLR.

Valor devuelto

HRESULT	Descripción
S_OK	BeginConnection finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	dwConnectionId tiene el valor cero, o ya se ha llamado a BeginConnection utilizando este valor de dwConnectionId, o szConnectionName tiene un valor null.
E_OUTOFMEMORY	No se ha podido asignar suficiente memoria para contener la lista de tareas asociadas a esta conexión.

Comentarios

ICLRDebugManager proporciona tres métodos, BeginConnection, SetConnectionTasks y EndConnection, para asociar listas de tareas con identificadores y nombres descriptivos.

Importante
Estos tres métodos deben invocarse en un orden concreto en cada conjunto de tareas.BeginConnection se invoca primero para establecer una nueva conexión.SetConnectionTasks se invoca a continuación para proporcionar un conjunto de tareas que se van a asociar con esa conexión.EndConnection se invoca en último lugar para quitar la asociación entre la lista de tareas, el identificador y el nombre descriptivo. Sin embargo, puede haber llamadas para otras conexiones que estén anidadas.

Estos tres métodos deben invocarse en un orden concreto en cada conjunto de tareas.BeginConnection se invoca primero para establecer una nueva conexión.SetConnectionTasks se invoca a continuación para proporcionar un conjunto de tareas que se van a asociar con esa conexión.EndConnection se invoca en último lugar para quitar la asociación entre la lista de tareas, el identificador y el nombre descriptivo. Sin embargo, puede haber llamadas para otras conexiones que estén anidadas.