Partilhar via

Função FwpmCalloutDeleteById0 (fwpmk.h)

  • Artigo

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

Sintaxe

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

Parâmetros

[in] engineHandle

Um identificador para uma sessão aberta no mecanismo de filtro. Um driver de texto explicativo chama a função FwpmEngineOpen0 para abrir uma sessão no 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.

Valor de retorno

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 da ID.
outros códigos NTSTATUS Ocorreu um erro.

Observações

Um driver 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 de da Plataforma de Filtragem do Windows.

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.

FwpmCalloutDeleteById0 é uma versão específica do FwpmCalloutDeleteById. 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

Consulte também