Función FwpmEngineOpen0 (fwpmu.h)
La función FwpmEngineOpen0 abre una sesión en el motor de filtro.
Sintaxis
DWORD 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
Tipo: const wchar_t*
Este valor debe ser NULL.
[in] authnService
Tipo: UINT32
Especifica el servicio de autenticación que se va a usar. Los servicios permitidos son RPC_C_AUTHN_WINNT y RPC_C_AUTHN_DEFAULT.
[in, optional] authIdentity
Tipo: SEC_WINNT_AUTH_IDENTITY_A*
Las credenciales de autenticación y autorización para acceder al motor de filtros. Este puntero es opcional y puede ser NULL. Si este puntero es NULL, se usan las credenciales del subproceso que realiza la llamada.
[in, optional] session
Tipo: FWPM_SESSION0*
Parámetros específicos de la sesión que se abre. Este puntero es opcional y puede ser NULL.
[out] engineHandle
Tipo: HANDLE*
Identificador de la sesión abierta en el motor de filtro.
Valor devuelto
Tipo: DWORD
| Código o valor devuelto | Descripción |
|---|---|
|
La sesión se inició correctamente. |
|
Ya se ha abierto una sesión con sessionKey especificada. |
|
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
Error al comunicarse con el motor de firewall remoto o local. |
Comentarios
Una aplicación de usuario debe llamar a FwpmEngineOpen0 para obtener un identificador para abrir la sesión en el motor de filtro antes de agregar o quitar los objetos de filtro. También se requiere un identificador para una sesión abierta en el motor de filtros para la mayoría de las demás funciones de administración de la Plataforma de filtrado de Windows.
La sesión se cierra automáticamente cuando finaliza el programa. Para cerrar explícitamente una sesión, llame a FwpmEngineClose0.
Si la sesión. las marcas se establecen en FWPM_SESSION_FLAG_DYNAMIC, los objetos DE PMA agregados durante la sesión se eliminan automáticamente cuando finaliza la sesión. Si la sesión no es dinámica, el autor de la llamada debe eliminar explícitamente todos los objetos DE PMA agregados durante la sesión.
El autor de la llamada necesita FWPM_ACTRL_OPEN acceso al motor de filtro. Consulte Access Control para obtener más información.
FwpmEngineOpen0 está pensado para su uso solo en modo no suplantado.
FwpmEngineOpen0 es una implementación específica de FwpmEngineOpen. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.
Ejemplos
En el ejemplo de C++ siguiente se usa FwpmEngineOpen0 para abrir una sesión de filtro.
// Open a session to the filter engine
HANDLE engineHandle = NULL;
DWORD result = ERROR_SUCCESS;
printf("Opening the filter engine.\n");
result = FwpmEngineOpen0(
NULL,
RPC_C_AUTHN_WINNT,
NULL,
NULL,
&engineHandle );
if (result != ERROR_SUCCESS)
printf("FwpmEngineOpen0 failed. Return value: %d.\n", result);
else
printf("Filter engine opened successfully.\n");
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | fwpmu.h |
| Library | Fwpuclnt.lib |
| Archivo DLL | Fwpuclnt.dll |