Compartilhar via


Função FwpmCalloutDeleteById0 (fwpmk.h)

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