Función DeleteUmsThreadContext (winbase.h)

  • Artículo

Elimina el contexto de subproceso de programación en modo de usuario (UMS) especificado. El subproceso debe finalizarse.

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 DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

Parámetros

[in] UmsThread

Puntero al contexto del subproceso de UMS que se va a eliminar. La función CreateUmsThreadContext proporciona este puntero.

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.

Comentarios

No se puede eliminar un contexto de subproceso de UMS hasta que finalice el subproceso asociado.

Cuando un subproceso de trabajo de UMS termina de ejecutarse (por ejemplo, devolviendo desde su función de punto de entrada de subproceso), el sistema finaliza el subproceso, establece el estado de finalización en el contexto del subproceso umS y pone en cola el contexto del subproceso de UMS en la lista de finalización asociada.

Cualquier intento de ejecutar el subproceso de UMS producirá un error porque el subproceso ya ha terminado.

Para comprobar el estado de finalización de un subproceso, el programador de la aplicación debe llamar a QueryUmsThreadInformation con la clase de información UmsIsThreadTerminated .

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

CreateUmsThreadContext

QueryUmsThreadInformation