Compartir a través de

Función SetUmsThreadInformation (winbase.h)

  • Artículo

Establece información de contexto específica de la aplicación para 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 SetUmsThreadInformation(
  [in] PUMS_CONTEXT          UmsThread,
  [in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [in] PVOID                 UmsThreadInformation,
  [in] ULONG                 UmsThreadInformationLength
);

Parámetros

[in] UmsThread

Puntero a un contexto de subproceso de UMS.

[in] UmsThreadInfoClass

Valor de UMS_THREAD_INFO_CLASS que especifica el tipo de información que se va a establecer. Este parámetro debe ser UmsThreadUserContext.

[in] UmsThreadInformation

Puntero a un búfer que contiene la información que se va a establecer.

[in] UmsThreadInformationLength

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

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 tamaño del búfer no coincide con el tamaño necesario para la clase de información especificada.
ERROR_INVALID_INFO_CLASS
 El parámetro UmsThreadInfoClass especifica una clase de información que no se admite.
ERROR_NOT_SUPPORTED
 No se admite UMS.

Comentarios

La función SetUmsThreadInformation se puede usar para establecer un contexto definido por la aplicación para el subproceso de trabajo de UMS especificado. La información de contexto puede constar de cualquier cosa que la aplicación pueda encontrar útil para realizar un seguimiento, como el estado por programador o por subproceso de trabajo. El sistema administra las estructuras subyacentes para los subprocesos de trabajo de UMS y no se debe modificar directamente.

La función QueryUmsThreadInformation se puede usar para recuperar otra información expuesta sobre el subproceso especificado, como su bloque de ejecución de subprocesos (TEB) y si el subproceso está suspendido o terminado. La información que no se expone a través de QueryUmsThreadInformation debe considerarse reservada.

Requisitos

   
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

QueryUmsThreadInformation