Compartir a través de

Función QueryUmsThreadInformation (winbase.h)

  • Artículo

Recupera información sobre el subproceso de trabajo de programación en modo de usuario (UMS) especificado.

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 QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

Parámetros

[in] UmsThread

Puntero a un contexto de subproceso de UMS.

[in] UmsThreadInfoClass

Valor UMS_THREAD_INFO_CLASS que especifica el tipo de información que se va a recuperar.

[out] UmsThreadInformation

Puntero a un búfer para recibir la información especificada. El tamaño necesario de este búfer depende de la clase de información especificada.

Si la clase de información es UmsThreadContext o UmsThreadTeb, el búfer debe ser sizeof(PVOID).

Si la clase de información es UmsThreadIsSuspended o UmsThreadIsTerminated, el búfer debe ser sizeof(BOOLEAN).

[in] UmsThreadInformationLength

Tamaño del búfer UmsThreadInformation , en bytes.

[out, optional] ReturnLength

Puntero a una variable ULONG. En la salida, este parámetro recibe el número de bytes escritos en el búfer UmsThreadInformation .

Valor devuelto

Si la función se ejecuta correctamente, devuelve un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto Descripción
ERROR_INFO_LENGTH_MISMATCH
 El búfer es demasiado pequeño para la información solicitada.
ERROR_INVALID_INFO_CLASS
 No se admite la clase de información especificada.
ERROR_NOT_SUPPORTED
 No se admite UMS.

Comentarios

La función QueryUmsThreadInformation recupera información sobre el subproceso de trabajo de UMS especificado, como su contexto definido por la aplicación, su bloque de ejecución de subprocesos (TEB) y si el subproceso está suspendido o terminado.

El sistema administra las estructuras subyacentes para los subprocesos de trabajo de UMS. La información que no se expone a través de QueryUmsThreadInformation debe considerarse reservada.

Requisitos

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

Consulte también

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS