Compartir a través de

Función FwpmProviderContextAdd3 (fwpmu.h)

Agrega un nuevo contexto de proveedor al sistema.

Sintaxis

DWORD FwpmProviderContextAdd3(
  HANDLE                       engineHandle,
  const FWPM_PROVIDER_CONTEXT3 *providerContext,
  PSECURITY_DESCRIPTOR         sd,
  UINT64                       *id
);

Parámetros

engineHandle

Tipo: _In_ HANDLE

Identificador de una sesión abierta con el motor de filtro. Para abrir una sesión con el motor de filtro, llame a FwpmEngineOpen0.

providerContext

Tipo: _In_ FWPM_PROVIDER_CONTEXT3*

Objeto de contexto de proveedor que se va a agregar.

sd

Tipo: PSECURITY_DESCRIPTOR de _In_opt_

Información de seguridad opcional asociada al objeto de contexto del proveedor.

id

Tipo: _Out_opt_ UINT64*

Puntero a una variable que recibe un identificador en tiempo de ejecución para este contexto de proveedor.

Valor devuelto

Tipo: DWORD*

Código o valor devuelto Descripción
ERROR_SUCCESS
0		 El contexto del proveedor se agregó correctamente.
ERROR_NOT_SUPPORTED
0x32		 El FWPM_IPSEC_IKE_MM_CONTEXT y el método de autenticación IKEEXT_IPV6_CGA se encuentran en la matriz authenticationMethods , pero la dirección generada criptográficamente (CGA) no está habilitada en el registro.
código de error FWP_E_*
0x80320001: 0x80320039		 Error específico de la Plataforma de filtrado de Windows (PMA). Para obtener más información, consulte Códigos de error de PMA.
RPC_* código de error*
0x80010001: 0x80010122		 Error al comunicarse con el motor de firewall remoto o local.

Comentarios

El sistema asigna algunos campos de la estructura FWPM_PROVIDER_CONTEXT2 , no el autor de la llamada, y se omiten en la llamada a FwpmProviderContextAdd3.

Si proporciona un descriptor de seguridad NULL , el sistema asignará un descriptor de seguridad predeterminado.

No se puede llamar a esta función dentro de una transacción de solo lectura. Se producirá un error con FWP_E_INCOMPATIBLE_TXN. Para obtener más información sobre las transacciones, consulta Administración de objetos.

Para llamar a esta función, necesita FWPM_ACTRL_ADD acceso al contenedor del contexto del proveedor y FWPM_ACTRL_ADD_LINK acceso al proveedor (si existe). Para obtener más información, consulta Control de acceso.

Requisitos

Requisito Valor
Header fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll
  • Last updated on