ICLRDebugManager::EndConnection (Método)

Artículo
08/10/2011

Quita la asociación entre una lista de tareas y un identificador y un nombre descriptivo.

HRESULT EndConnection (
    [in] CONNID dwConnectionId
);

Parámetros

dwConnectionId
[in] Identificador específico del host para la conexión y la lista asociada de tareas de Common Language Runtime (CLR).

Valor devuelto

HRESULT	Descripción
S_OK	EndConnection 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	No se llamó nunca a BeginConnection utilizando dwConnectionId, o dwConnectionId era cero.

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.