Função FwpmCalloutDeleteByKey0 (fwpmu.h)

  • Artigo

A função FwpmCalloutDeleteByKey0 remove um objeto de texto explicativo do sistema.

Sintaxe

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

Parâmetros

[in] engineHandle

Tipo: HANDLE

Identificador de uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.

[in] key

Tipo: const GUID*

Identificador exclusivo do texto explicativo que está sendo removido do sistema. Esse GUID foi especificado no membro calloutKey do parâmetro de texto explicativo quando o aplicativo chamou FwpmCalloutAdd0 para esse objeto.

Valor retornado

Tipo: DWORD

Valor/código retornado Descrição
ERROR_SUCCESS
0
 O texto explicativo foi excluído com êxito.
código de erro FWP_E_*
0x80320001 — 0x80320039
 Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes.
código de erro RPC_*
0x80010001 — 0x80010122
 Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

Os textos explicativos de um aplicativo não podem ser removidos do sistema, desde que haja filtros no sistema que especifiquem os textos explicativos para uma ação.

Essa função não pode ser chamada de dentro de uma transação somente leitura. Ele falhará com FWP_E_INCOMPATIBLE_TXN. Consulte Gerenciamento de Objetos para obter mais informações sobre transações.

Essa função poderá ser chamada dentro de uma sessão dinâmica se o objeto correspondente tiver sido adicionado durante a mesma sessão. Se essa função for chamada para um objeto que foi adicionado durante uma sessão dinâmica diferente, ela falhará com FWP_E_WRONG_SESSION. Se essa função for chamada para um objeto que não foi adicionado durante uma sessão dinâmica, ela falhará com FWP_E_DYNAMIC_SESSION_IN_PROGRESS.

O chamador precisa de acesso DELETE ao texto explicativo. Consulte Controle de Acesso para obter mais informações.

FwpmCalloutDeleteByKey0 é uma implementaçã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.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll

Confira também

FwpmCalloutAdd0

Modo Kernel FwpmCalloutDeleteByKey0