Función OpenProcessToken (processthreadsapi.h)
La función OpenProcessToken abre el token de acceso asociado a un proceso.
Sintaxis
BOOL OpenProcessToken(
[in] HANDLE ProcessHandle,
[in] DWORD DesiredAccess,
[out] PHANDLE TokenHandle
);
Parámetros
[in] ProcessHandle
Identificador del proceso cuyo token de acceso se abre. El proceso debe tener el permiso de acceso PROCESS_QUERY_LIMITED_INFORMATION. Consulta Derechos de seguridad y acceso de procesos para obtener más información.
[in] DesiredAccess
Especifica una máscara de acceso que especifica los tipos de acceso solicitados al token de acceso. Estos tipos de acceso solicitados se comparan con la lista de control de acceso discrecional (DACL) del token para determinar qué accesos se conceden o deniegan.
Para obtener una lista de los derechos de acceso de los tokens de acceso, consulte Derechos de acceso para Access-Token Objetos.
[out] TokenHandle
Puntero a un identificador que identifica el token de acceso recién abierto cuando la función devuelve.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es 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
Para obtener un identificador de un proceso con privilegios elevados desde un proceso sin privilegios elevados, ambos procesos deben iniciarse desde la misma cuenta.
Si otra cuenta inició el proceso que se está comprobando, el proceso de comprobación debe tener habilitado el privilegio SE_DEBUG_NAME. Consulta Constantes de privilegios (autorización) para obtener más información.
Para cerrar el identificador del token de acceso devuelto a través del parámetro TokenHandle , llame a CloseHandle.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | processthreadsapi.h (incluya Windows.h) |
Library | Advapi32.lib |
Archivo DLL | Advapi32.dll |
Consulte también
Funciones básicas de Access Control