Función OpenProcessToken (processthreadsapi.h)

Artículo
08/25/2023

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