Função FwpmCalloutAdd0 (fwpmu.h)

  • Artigo

A função FwpmCalloutAdd0 adiciona um novo objeto de texto explicativo ao sistema.

Sintaxe

DWORD FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

Parâmetros

[in] engineHandle

Tipo: HANDLE

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

[in] callout

Tipo: FWPM_CALLOUT0*

O objeto de texto explicativo a ser adicionado.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

As informações de segurança associadas ao texto explicativo.

[out, optional] id

Tipo: UINT32*

Identificador de runtime para esse texto explicativo.

Retornar valor

Tipo: DWORD

Valor/código retornado Descrição
ERROR_SUCCESS
0
 O texto explicativo foi adicionado com êxito.
FWP_E_INVALID_PARAMETER
0x80320035
 FWPM_TUNNEL_FLAG_POINT_TO_POINT não foi definido e foram especificadas condições diferentes do endereço local/remoto.
código de erro FWP_E_*
0x80320001 — 0x80320039
 Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro 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

Alguns campos na estrutura FWPM_CALLOUT0 são atribuídos pelo sistema, não pelo chamador e são ignorados na chamada para FwpmCalloutAdd0. Se o chamador fornecer um descritor de segurança nulo, o sistema atribuirá um descritor de segurança padrão.

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 texto explicativo, FWPM_ACTRL_ADD_LINK acesso ao provedor (se houver) e FWPM_ACTRL_ADD_LINK acesso à camada aplicável. Consulte Controle de Acesso para obter mais informações.

Para adicionar um filtro que faça referência a um texto explicativo, invoque as funções na ordem a seguir.

  • Chame FwpsCalloutRegister (documentado no WDK (Kit de Driver do Windows) para registrar o texto explicativo com o mecanismo de filtro.
  • Chame FwpmCalloutAdd0 para adicionar o texto explicativo ao sistema.
  • Chame FwpmFilterAdd0 para adicionar o filtro que faz referência ao texto explicativo ao sistema.
Por padrão, os filtros que fazem referência a textos explicativos que foram adicionados, mas que ainda não foram registrados com o mecanismo de filtro, são tratados como Filtros de bloco.

FwpmCalloutAdd0 é uma implementação específica de FwpmCalloutAdd. 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_CALLOUT0

Kernel-Mode FwpmCalloutAdd0