Función FwpsOpenToken0 (fwpsk.h)

La función FwpsOpenToken0 abre un token de acceso.

NotaFwpsOpenToken0 es una versión específica de FwpsOpenToken. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

 

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 (DACL) del token 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	Se produjo un error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 7.
Plataforma de destino	Universal
Encabezado	fwpsk.h (incluya Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

Consulte también

FwpmEngineOpen0