Partekatu bidez

ICLRDebugManager::BeginConnection (Método)

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

Sintaxis

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 se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Si se devuelve este valor, significa que ocurrió un error grave desconocido. Una vez que un método devuelva el valor E_FAIL, CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG dwConnectionId ha sido cero, BeginConnection ya se ha llamado con este valor dwConnectionId o szConnectionName ha sido null.
E_OUTOFMEMORY No se ha podido asignar memoria suficiente 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

Se debe llamar a estos tres métodos en un orden específico para cada conjunto de tareas. Se llama a BeginConnection primero para establecer una nueva conexión. Posteriormente, se llama a SetConnectionTasks para proporcionar el conjunto de tareas que se van a asociar a esa conexión. Por último, se llama a EndConnection para quitar la asociación entre la lista de tareas, y el identificador y el nombre descriptivo. Pero las llamadas para diferentes conexiones se pueden anidar.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también

  • Last updated on