Função FwpmCalloutAdd0 (fwpmk.h)

Artigo
07/16/2024

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

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 no mecanismo de filtro. Um driver explicativo chama a função FwpmEngineOpen0 para abrir uma sessão no 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 em 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 do ao remover o texto explicativo do mecanismo de filtro. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

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 apontado pelo parâmetro de texto explicativo .
outros códigos NTSTATUS	Ocorreu um erro.

Observações

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

Normalmente, os drivers de texto explicativo 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 com o mecanismo de filtro.

FwpmCalloutAdd0 é uma versão específica do FwpmCalloutAdd. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Requisitos

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

Compartilhar via