ICLRDebugManager::SetConnectionTasks (Método)
Asocia una lista de instancias de ICLRTask con un identificador y un nombre descriptivo.
Sintaxis
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 con la que se va a asociar la matriz ppCLRTask.
dwCount
[in] Número de miembros de ppCLRTask. Este número debe ser mayor que cero.
ppCLRTask
[in] Matriz de punteros ICLRTask que se van 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 se devolvió correctamente. |
| HOST_E_CLRNOTAVAILABLE | El 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 o 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 | No se ha llamado BeginConnection con este valor de id, o 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
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
