Função FwpmCalloutAdd0 (fwpmk.h)

A função FwpmCalloutAdd0 adiciona um texto explicativo ao mecanismo de filtro.

ObservaçãoFwpmCalloutAdd0 é uma versã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.

 

Sintaxe

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

Parâmetros

[in] engineHandle

Um identificador para uma sessão aberta para o mecanismo de filtro. Um driver de texto explicativo chama a função FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.

[in] callout

Um ponteiro para uma estrutura de FWPM_CALLOUT0 constante que contém os dados necessários para adicionar o texto explicativo ao mecanismo de filtro.

[in, optional] sd

Um ponteiro para uma estrutura de SECURITY_DESCRIPTOR constante que descreve o descritor de segurança para o texto explicativo que está sendo adicionado ao mecanismo de filtro. Esse parâmetro é opcional e pode ser NULL.

[out, optional] id

Um ponteiro para uma variável do tipo UINT32 que recebe um identificador de tempo de execução que identifica o texto explicativo no mecanismo de filtro. Esse é o mesmo identificador retornado quando um driver de texto explicativo registra as funções de texto explicativo do driver de texto explicativo com o mecanismo de filtro. O driver de texto explicativo passa esse identificador para a função FwpmCalloutDeleteById0 ao remover o texto explicativo do mecanismo de filtro. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

A função FwpmCalloutAdd0 retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O texto explicativo foi adicionado com êxito ao mecanismo de filtro.
STATUS_FWP_ALREADY_EXISTS	Não foi possível adicionar o texto explicativo ao mecanismo de filtro. Já existe um texto explicativo no mecanismo de filtro com um identificador idêntico ao GUID especificado no membro calloutKey da estrutura FWPM_CALLOUT0 apontada pelo parâmetro callout .
Outros códigos de status	Ocorreu um erro.

Comentários

Um driver de texto explicativo chama a função FwpmCalloutAdd0 para adicionar um texto explicativo ao mecanismo de filtro.

Os drivers de texto explicativo normalmente não adicionam seus textos explicativos ao mecanismo de filtro. Na maioria das situações, isso é tratado por um aplicativo de gerenciamento da Plataforma de Filtragem do Windows no modo de usuário.

Um texto explicativo e filtros que especificam o texto explicativo para a ação do filtro podem ser adicionados ao mecanismo de filtro antes que um driver de texto explicativo registre o texto explicativo com o mecanismo de filtro. Nessa situação, filtros com um tipo de ação de FWP_ACTION_CALLOUT_TERMINATING ou FWP_ACTION_CALLOUT_UNKNOWN são tratados como FWP_ACTION_BLOCK e filtros com um tipo de ação de FWP_ACTION_CALLOUT_INSPECTION são ignorados até que o texto explicativo seja registrado no mecanismo de filtro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows Vista.
Plataforma de Destino	Universal
Cabeçalho	fwpmk.h (inclua Fwpmk.h)
Biblioteca	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Confira também

FWPM_CALLOUT0

FwpmCalloutDeleteById0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0

Tipos de textos explicativos