Compartilhar via

Função FwpmProviderContextAdd3 (fwpmu.h)

  • Artigo

Adiciona um novo contexto de provedor ao sistema.

Sintaxe

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

Parâmetros

engineHandle

Tipo: _In_ HANDLE

Um identificador para uma sessão aberta com o mecanismo de filtro. Para abrir uma sessão com o mecanismo de filtro, chame FwpmEngineOpen0.

providerContext

Tipo: _In_ FWPM_PROVIDER_CONTEXT3*

O objeto de contexto do provedor a ser adicionado.

sd

Tipo: _In_opt_ PSECURITY_DESCRIPTOR

Informações de segurança opcionais associadas ao objeto de contexto do provedor.

id

Tipo: _Out_opt_ UINT64*

Ponteiro para uma variável que recebe um identificador de runtime para esse contexto de provedor.

Retornar valor

Tipo: DWORD*

Valor/código retornado Descrição
ERROR_SUCCESS
0		 O contexto do provedor foi adicionado com êxito.
ERROR_NOT_SUPPORTED
0x32		 O FWPM_IPSEC_IKE_MM_CONTEXT e o método de autenticação IKEEXT_IPV6_CGA estão na matriz authenticationMethods , mas o endereço gerado criptograficamente (CGA) não está habilitado no registro.
código de erro FWP_E_*
0x80320001 — 0x80320039		 Um erro específico da Plataforma de Filtragem do Windows (WFP). Para obter detalhes, consulte Códigos de erro do WFP.
código de erro RPC_*
0x80010001 — 0x80010122		 Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

Alguns campos na estrutura FWPM_PROVIDER_CONTEXT2 são atribuídos pelo sistema, não pelo chamador e são ignorados na chamada para FwpmProviderContextAdd3.

Se você fornecer um descritor de segurança NULL , o sistema atribuirá um descritor de segurança padrão.

Você não pode chamar essa função em uma transação somente leitura. Ele falhará com FWP_E_INCOMPATIBLE_TXN. Para obter mais informações sobre transações, consulte Gerenciamento de objetos.

Para chamar essa função, você precisa FWPM_ACTRL_ADD acesso ao contêiner do contexto do provedor e FWPM_ACTRL_ADD_LINK acesso ao provedor (se houver). Para obter mais informações, consulte Controle de acesso.

Requisitos

Requisito Valor
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll