Compartilhar via


Função FwpmCalloutDeleteByKey0 (fwpmk.h)

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

Sintaxe

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

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] key

Um ponteiro para um GUID que identifica exclusivamente o texto explicativo que está sendo excluído do mecanismo de filtro. Esse deve ser um ponteiro para o mesmo GUID que foi especificado 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 FwpmCalloutDeleteByKey0 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 GUID especificado no parâmetro de chave .
outros códigos NTSTATUS Ocorreu um erro.

Observações

Um driver explicativo chama a função FwpmCalloutDeleteByKey0 para excluir um texto explicativo do mecanismo de filtro, usando a chave GUID 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.

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