Compartilhar via


Função FwpmProviderAdd0 (fwpmu.h)

A função FwpmProviderAdd0 adiciona um novo provedor ao sistema.

Sintaxe

DWORD FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

Parâmetros

[in] engineHandle

Tipo: HANDLE

Identificador de uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.

[in] provider

Tipo: FWPM_PROVIDER0*

O objeto do provedor a ser adicionado.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

Informações de segurança para o objeto do provedor.

Retornar valor

Tipo: DWORD

Valor/código retornado Descrição
ERROR_SUCCESS
0
O provedor foi adicionado com êxito.
código de erro FWP_E_*
0x80320001 — 0x80320039
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes.
código de erro RPC_*
0x80010001 — 0x80010122
Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

Se o chamador fornecer um descritor de segurança nulo, o sistema atribuirá um descritor de segurança padrão.

Objetos de tempo de inicialização são adicionados ao BFE (Mecanismo de Filtragem Base) quando o driver TCP/IP é iniciado e são removidos quando o BFE conclui a inicialização. Objetos persistentes são adicionados quando o BFE é iniciado. Se um provedor de política tiver uma política persistente que não se destina a ser imposta se o serviço associado estiver desabilitado, o chamador poderá especificar um nome de serviço opcional na estrutura FWPM_PROVIDER0 . Em seguida, esse serviço possui o objeto de política persistente. No início, a BFE adiciona apenas os seguintes tipos de objetos persistentes ao sistema.

  • O objeto não está associado a um provedor.
  • O objeto tem um provedor associado que não especifica um nome de serviço.
  • O objeto tem um provedor associado e um serviço associado definido como inicialização automática.
Essa função não pode ser chamada de dentro de uma transação somente leitura. Ele falhará com FWP_E_INCOMPATIBLE_TXN. Consulte Gerenciamento de Objetos para obter mais informações sobre transações.

O chamador precisa FWPM_ACTRL_ADD acesso ao contêiner do provedor. Consulte Controle de Acesso para obter mais informações.

FwpmProviderAdd0 é uma implementação específica de FwpmProviderAdd. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll

Confira também

FWPM_PROVIDER0