Compartilhar via


Função FwpmCalloutDeleteByKey0 (fwpmk.h)

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

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

Sintaxe

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

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

Um ponteiro para um GUID que identifica exclusivamente o texto explicativo que está sendo excluído do mecanismo de filtro. Isso 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.

Retornar valor

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 de status
Ocorreu um erro.

Comentários

Um driver de texto 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.

Os drivers de texto explicativo normalmente 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

FwpmCalloutDeleteById0

FwpmEngineOpen0