Compartir a través de

Función FwpmEngineOpen0 (fwpmk.h)

  • Artículo

La función FwpmEngineOpen0 abre una sesión en el motor de filtro.

Sintaxis

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

Parámetros

[in, optional] serverName

Puntero a una cadena terminada en NULL que especifica el nombre DNS estándar del sistema en el que se abre la sesión en el motor de filtro. Los controladores de llamada deben especificar NULL para este parámetro.

[in] authnService

Servicio de autenticación que se va a usar. Para obtener una lista de opciones válidas para este parámetro, consulte Authentication-Service Constantes en la sección RPC de la documentación del SDK de Microsoft Windows. Los controladores de llamada deben especificar RPC_C_AUTHN_WINNT o RPC_C_AUTHN_DEFAULT para este parámetro.

[in, optional] authIdentity

Puntero a una estructura de SEC_WINNT_AUTH_IDENTITY_W que contiene las credenciales de autenticación y autorización para acceder al motor de filtro. Este parámetro se omite cuando se llama a la función FwpmEngineOpen0 desde un controlador de llamada. Los controladores de llamada deben establecer este parámetro en NULL.

[in, optional] session

Puntero a una estructura de FWPM_SESSION0 que define parámetros específicos de la sesión para la sesión que se abre. Este puntero es opcional y se puede NULL.

[out] engineHandle

Puntero a una variable que recibe un identificador para la sesión abierta en el motor de filtro.

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS Se abrió correctamente una sesión en el motor de filtro. La variable a la que apunta el parámetro engineHandle contiene un identificador para la sesión abierta.
otros códigos NTSTATUS Error.

Observaciones

Un controlador de llamada llama a la función FwpmEngineOpen0 para abrir una sesión en el motor de filtro. Un identificador de una sesión abierta en el motor de filtro es un parámetro necesario para la mayoría de las funciones de administración de la plataforma de filtrado de Windows.

Normalmente, los controladores de llamada no necesitan abrir una sesión en el motor de filtro porque los controladores de llamada normalmente no llaman a ninguna de las funciones de administración de plataforma de filtrado de Windows .

Para que un controlador de llamada abra correctamente una sesión en el motor de filtro, el motor de filtros debe estar ejecutándose actualmente en el momento en que el controlador de llamada llama a la función FwpmEngineOpen0. Un controlador de llamada puede llamar a la función FwpmBfeStateGet0 para obtener el estado actual del motor de filtro. Antes de llamar a FwpmBfeStateGet0, el controlador de llamada debe llamar al FwpmBfeStateSubscribeChanges0 función para registrar una función de devolución de llamada a la que se llamará siempre que haya un cambio en el estado del motor de filtro.

Una vez que un controlador de llamada haya terminado de acceder al motor de filtro, llama a la función FwpmEngineClose0 para cerrar la sesión abierta en el motor de filtro.

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

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows Vista.
de la plataforma de destino de Universal
encabezado de fwpmk.h (incluya Fwpmk.h)
biblioteca de Fwpkclnt.lib
irQL PASSIVE_LEVEL

Consulte también