Compartilhar via

Função FwpmCalloutDeleteByKey0 (fwpmk.h)

  • Artigo

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