Función CreateUmsThreadContext (winbase.h)
Crea un contexto de subproceso de programación en modo de usuario (UMS) para representar un subproceso de trabajo de 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 CreateUmsThreadContext(
[out] PUMS_CONTEXT *lpUmsThread
);
Parámetros
[out] lpUmsThread
Variable PUMS_CONTEXT. En la salida, este parámetro recibe un puntero a un contexto de subproceso umS.
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 |
|---|---|
|
No hay suficiente memoria disponible para crear el contexto del subproceso de UMS. |
Comentarios
Un contexto de subproceso de UMS representa el estado de un subproceso de trabajo de UMS. Los contextos de subprocesos se usan para especificar subprocesos de trabajo de UMS en llamadas de función.
Se crea un subproceso de trabajo de UMS llamando a la función CreateRemoteThreadEx después de usar InitializeProcThreadAttributeList y UpdateProcThreadAttribute para preparar una lista de atributos umS para el subproceso.
El sistema administra las estructuras subyacentes para un contexto de subproceso de UMS y no debe modificarse directamente. Para obtener y establecer información sobre un subproceso de trabajo de UMS, use las funciones QueryUmsThreadInformation y SetUmsThreadInformation .
Una vez finalizado un subproceso de trabajo de UMS, su contexto de subproceso debe liberarse llamando a DeleteUmsThreadContext.
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) |