Función FwpsOpenToken0 (fwpsk.h)

La función FwpsOpenToken0 abre un token de acceso.

NotafwpsOpenToken0 es una versión específica de FwpsOpenToken. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

 

Sintaxis

NTSTATUS FwpsOpenToken0(
  [in]  IN HANDLE  engineHandle,
  [in]  IN LUID    modifiedId,
  [in]  IN DWORD   desiredAccess,
  [out] OUT HANDLE *accessToken
);

Parámetros

[in] engineHandle

Identificador de una sesión abierta en el motor de filtro. Un controlador de llamada llama a la función FwpmEngineOpen0 para abrir una sesión en el motor de filtro.

[in] modifiedId

Especifica un LUID que cambia cada vez que se modifica el token. Una aplicación puede usar este valor como prueba de si un contexto de seguridad ha cambiado desde que se usó por última vez.

[in] desiredAccess

ACCESS_MASK estructura 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 del token (DACL) para determinar qué accesos se conceden o deniegan.

[out] accessToken

Puntero a una variable asignada por el autor de la llamada que recibe un identificador del token de acceso recién abierto.

Valor devuelto

La función FwpsOpenToken0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	El token de acceso se abrió correctamente.
otros códigos de estado	Error.

Observaciones

El proceso que llama a fwpsopentoken0 debe tener habilitado el privilegio SE_DEBUG_NAME en su token de proceso.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 7.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
irQL	<= PASSIVE_LEVEL

Consulte también

FwpmEngineOpen0