Función GetUmsSystemThreadInformation (winbase.h)

Consulta si el subproceso especificado es un subproceso del programador de UMS, un subproceso de trabajo de UMS o un subproceso que no es ums.

Advertencia

A partir de Windows 11, no se admite la programación en modo de usuario. Todas las llamadas producen el error ERROR_NOT_SUPPORTED.

Sintaxis

BOOL GetUmsSystemThreadInformation(
  [in]      HANDLE                         ThreadHandle,
  [in, out] PUMS_SYSTEM_THREAD_INFORMATION SystemThreadInfo
);

Parámetros

[in] ThreadHandle

Identificador de un subproceso. El identificador de subproceso debe tener el derecho de acceso THREAD_QUERY_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de subprocesos.

[in, out] SystemThreadInfo

Puntero a una estructura UMS_SYSTEM_THREAD_INFORMATION que recibe información sobre el subproceso especificado.

El llamador debe inicializar el UmsVersion miembro antes de llamar.

Valor devuelto

Si la función no se realiza correctamente, el valor devuelto es cero.

Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función GetUmsSystemThreadInformation está pensada para su uso en depuradores, herramientas de solución de problemas y aplicaciones de generación de perfiles. Por ejemplo, el seguimiento aislado de subprocesos o las instrucciones de paso a paso único pueden implicar la suspensión de todos los demás subprocesos del proceso. Sin embargo, si el subproceso que se va a realizar un seguimiento es un subproceso de trabajo de UMS, suspender subprocesos del programador de UMS podría provocar un interbloqueo porque un subproceso de trabajo de UMS requiere la intervención de un subproceso del programador de UMS para poder ejecutarse. Un depurador puede llamar a GetUmsSystemThreadInformation para cada subproceso que pueda suspender para determinar el tipo de subproceso y, a continuación, suspenderlo o no según sea necesario para el código que se está depurando.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 con SP1 [solo aplicaciones de escritorio],Windows 7 (solo 64 bits) y Windows Server 2008 R2 con KB977165 instalado
Servidor mínimo compatible	Windows Server 2008 R2 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll
Conjunto de API	api-ms-win-core-ums-l1-1-0 (introducido en Windows 7)