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 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 |
---|---|
|
O texto explicativo foi excluído com êxito do mecanismo de filtro. |
|
Um ou mais filtros no mecanismo de filtro especificam o texto explicativo para a ação do filtro. |
|
Não há um texto explicativo no mecanismo de filtro que corresponda ao GUID especificado no parâmetro de chave . |
|
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de