Função FwpsCalloutUnregisterByKey0 (fwpsk.h)

A função FwpsCalloutUnregisterByKey0 cancela o registro de um texto explicativo do mecanismo de filtro.

Observação FwpsCalloutUnregisterByKey0 é uma versão específica do FwpsCalloutUnregisterByKey. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

 

Sintaxe

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Parâmetros

[in] calloutKey

Um ponteiro para um GUID que identifica exclusivamente o texto explicativo que está sendo cancelado do mecanismo de filtro. Esse deve ser um ponteiro para o mesmo GUID especificado quando o driver de texto explicativo chamado FwpsCalloutRegister0 ou FwpsCalloutRegister1 funções para registrar o texto explicativo com o mecanismo de filtro.

Valor de retorno

A função FwpsCalloutUnregisterByKey0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O texto explicativo foi cancelado com êxito do mecanismo de filtro.
STATUS_DEVICE_BUSY	Há um ou mais fluxos de dados sendo processados pelo texto explicativo que têm um contexto pendente associado ao fluxo de dados. Um driver de texto explicativo deve chamar a função FwpsFlowRemoveContext0 para cada um desses fluxos de dados para remover o contexto associado. Depois que o contexto tiver sido removido com êxito de cada um desses fluxos de dados, o driver de texto explicativo deverá chamar a função FwpsCalloutUnregisterByKey0 novamente para concluir o cancelamento do registro do texto explicativo do mecanismo de filtro.
STATUS_FWP_CALLOUT_NOT_FOUND	Não há um texto explicativo registrado com o mecanismo de filtro que corresponda ao GUID especificado no parâmetro calloutKey.
STATUS_FWP_IN_USE	O texto explicativo já está em processo de registro ou não registrado em outro thread.
Outros códigos de status	Ocorreu um erro.

Observações

Um driver explicativo chama a função FwpsCalloutUnregisterByKey0 para cancelar o registro de um texto explicativo do mecanismo de filtro, usando a chave GUID para identificar que o texto explicativo não foi registrado. Essa função é bem-sucedida mesmo se houver filtros no mecanismo de filtro que especificam o texto explicativo para a ação do filtro. Nessa situação, filtros com um tipo de ação de FWP_ACTION_CALLOUT_TERMINATING ou FWP_ACTION_CALLOUT_UNKNOWN são tratados como FWP_ACTION_BLOCKe filtros com um tipo de ação de FWP_ACTION_CALLOUT_INSPECTION são ignorados após o texto explicativo ter sido desregistro do mecanismo de filtro.

Um driver de texto explicativo não pode ser descarregado até que todos os textos explicativos registrados anteriormente com o mecanismo de filtro não tenham sido registrados com êxito.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Consulte também

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

tipos de textos explicativos