Função FwpsCalloutUnregisterByKey0 (fwpsk.h)

  • Artigo

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

ObservaçãoFwpsCalloutUnregisterByKey0 é uma versão específica de FwpsCalloutUnregisterByKey. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas 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. Isso deve ser um ponteiro para o mesmo GUID que foi especificado quando o driver de texto explicativo chamou as funções FwpsCalloutRegister0 ou FwpsCalloutRegister1 para registrar o texto explicativo com o mecanismo de filtro.

Retornar valor

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á no processo de ser registrado ou não registrado em outro thread.
Outros códigos de status
 Ocorreu um erro.

Comentários

Um driver de texto explicativo chama a função FwpsCalloutUnregisterByKey0 para cancelar o registro de um texto explicativo do mecanismo de filtro, usando a chave GUID para identificar o texto explicativo a ser cancelado. Essa função terá êxito mesmo se houver filtros no mecanismo de filtro que especificam o texto explicativo para a ação do filtro. Nessa situação, os filtros com um tipo de ação de FWP_ACTION_CALLOUT_TERMINATING ou FWP_ACTION_CALLOUT_UNKNOWN são tratados como FWP_ACTION_BLOCK e os filtros com um tipo de ação de FWP_ACTION_CALLOUT_INSPECTION são ignorados depois que o texto explicativo é desregistrado 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 tenham sido cancelados com êxito.

Requisitos

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

Confira também

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

Tipos de textos explicativos