ICLRDebugManager::SetConnectionTasks (Método)

Artículo
08/10/2011

Asocia una lista de instancias de ICLRTask a un identificador y un nombre descriptivo.

HRESULT SetConnectionTasks (
    [in] CONNID id,
    [in] DWORD dwCount,
    [in, size_is(dwCount)] ICLRTask **ppCLRTask
);

Parámetros

id
[in] Identificador específico del host para la conexión a la que se va a asociar la matriz de ppCLRTask.
dwCount
[in] Número de miembros de ppCLRTask. Este número debe ser mayor que cero.
ppCLRTask
[in] Matriz de punteros de ICLRTask que se va a asociar a la conexión identificada por id. Esta matriz debe contener al menos un miembro.

Valor devuelto

HRESULT	Descripción
S_OK	SetConnectionTasks finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (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 ha llamado a BeginConnection utilizando este valor de id, o bien, el valor de dwCount o id es cero, o bien, uno de los elementos de ppCLRTask es NULL.

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.