Compartir a través de


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

Control de acceso

Funciones básicas de Access Control

AccessCheck

AdjustTokenGroups

AdjustTokenPrivileges

CloseHandle

GetCurrentProcessToken

GetCurrentThreadEffectiveToken

GetCurrentThreadToken

GetTokenInformation

OpenThreadToken

SetTokenInformation