Compartir a través de


Función WTSQueryUserToken (wtsapi32.h)

Obtiene el token de acceso principal del usuario que ha iniciado sesión especificado por el identificador de sesión. Para llamar correctamente a esta función, la aplicación que realiza la llamada debe ejecutarse en el contexto de la cuenta LocalSystem y tener el privilegio SE_TCB_NAME .

PrecauciónWTSQueryUserToken está pensada para servicios de alta confianza. Los proveedores de servicios deben tener cuidado de que no pierden tokens de usuario al llamar a esta función. Los proveedores de servicios deben cerrar los identificadores de token una vez que hayan terminado de usarlos.
 

Sintaxis

BOOL WTSQueryUserToken(
  [in]  ULONG   SessionId,
  [out] PHANDLE phToken
);

Parámetros

[in] SessionId

Identificador de sesión de Servicios de Escritorio remoto. Cualquier programa que se ejecute en el contexto de un servicio tendrá un identificador de sesión de cero (0). Puede usar la función WTSEnumerateSessions para recuperar los identificadores de todas las sesiones en un servidor host de sesión de Escritorio remoto especificado.

Para poder consultar la información de la sesión de otro usuario, debe tener el permiso Información de consulta. Para obtener más información, vea Permisos de Servicios de Escritorio remoto. Para modificar permisos en una sesión, use la herramienta administrativa Configuración de Servicios de Escritorio remoto.

[out] phToken

Si la función se realiza correctamente, recibe un puntero al identificador de token para el usuario que ha iniciado sesión. Tenga en cuenta que debe llamar a la función CloseHandle para cerrar este identificador.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero y el parámetro phToken apunta al token principal del usuario.

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

Comentarios

Para obtener información sobre los tokens principales, consulte Tokens de acceso. Para obtener más información sobre los privilegios de cuenta, vea Permisos y constantes de autorización de Servicios de Escritorio remoto.

Consulte Cuenta localSystem para obtener información sobre los privilegios asociados a esa cuenta.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wtsapi32.h
Library Wtsapi32.lib
Archivo DLL Wtsapi32.dll
Conjunto de API ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8)

Consulte también

CloseHandle

WTSEnumerateSessions