Compartilhar via

Função FwpmCalloutDeleteById0 (fwpmk.h)

  • Artigo

A função FwpmCalloutDeleteById0 exclui um texto explicativo do mecanismo de filtro.

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

Sintaxe

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] 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] id

O identificador de tempo de execução para o texto explicativo que está sendo excluído do mecanismo de filtro. Esse deve ser o identificador de tempo de execução que foi retornado quando o driver de texto explicativo chamou a função FwpmCalloutAdd0 para adicionar o texto explicativo ao mecanismo de filtro.

Retornar valor

A função FwpmCalloutDeleteById0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
 O texto explicativo foi excluído com êxito do mecanismo de filtro.
STATUS_FWP_IN_USE
 Um ou mais filtros no mecanismo de filtro especificam o texto explicativo para a ação do filtro.
STATUS_FWP_CALLOUT_NOT_FOUND
 Não há um texto explicativo no mecanismo de filtro que corresponda ao identificador de tempo de execução especificado no parâmetro id .
Outros códigos status
 Ocorreu um erro.

Comentários

Um driver de texto explicativo chama a função FwpmCalloutDeleteById0 para excluir um texto explicativo do mecanismo de filtro, usando o identificador de tempo de execução para identificar o texto explicativo a ser excluído.

Normalmente, os drivers de texto explicativo não excluem seus textos explicativos do 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 só poderá ser excluído do mecanismo de filtro se não houver filtros no mecanismo de filtro que especifiquem o texto explicativo para a ação do 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

FwpmCalloutAdd0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0