estrutura FWPM_CALLOUT0 (fwpmtypes.h)

  • Artigo

A estrutura FWPM_CALLOUT0 armazena o estado associado a um texto explicativo.

Sintaxe

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

Membros

calloutKey

Identifica exclusivamente a sessão.

Se o GUID for inicializado como zero na chamada para FwpmCalloutAdd0, o BFE (mecanismo de filtragem base) gerará um.

displayData

Uma estrutura FWPM_DISPLAY_DATA0 que contém anotações legíveis por humanos associadas ao texto explicativo. O membro de nome da estrutura FWPM_DISPLAY_DATA0 é necessário.

flags

Valor Significado
FWPM_CALLOUT_FLAG_PERSISTENT
 O texto explicativo é persistente entre reinicializações. Como resultado, ele pode ser referenciado por tempo de inicialização e outros filtros persistentes.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT
 O texto explicativo precisa de acesso ao contexto do provedor armazenado no filtro que invoca o texto explicativo. Se esse sinalizador for definido, o contexto do provedor será copiado da estrutura [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) para a estrutura FWPS_FILTER0 . A estrutura FWPS_FILTER0 está documentada no WDK.
FWPM_CALLOUT_FLAG_REGISTERED
 O texto explicativo está registrado atualmente no kernel. Esse sinalizador não deve ser definido ao adicionar novos textos explicativos. Ele é usado apenas para consultar o estado dos textos explicativos existentes.

providerKey

Identifica exclusivamente o provedor associado ao texto explicativo. Se o membro não for NULL, somente os objetos associados ao provedor especificado serão retornados.

providerData

Uma estrutura FWP_BYTE_BLOB que contém dados opcionais específicos do provedor que permitem que os provedores armazenem informações de contexto adicionais com o objeto .

applicableLayer

Especifica a camada na qual o texto explicativo pode ser usado. Somente filtros nessa camada podem invocar o texto explicativo. Para obter mais informações, consulte Filtrando identificadores de camada.

calloutId

LUID identificando o texto explicativo. Essa é a calloutId armazenada na estrutura FWPS_ACTION0 para filtros que invocam um texto explicativo. A estrutura FWPS_ACTION0 está documentada no WDK.

Comentários

Os primeiros seis membros dessa estrutura contêm dados fornecidos ao adicionar objetos.

O último membro, calloutId, fornece informações adicionais retornadas ao obter/enumerar objetos.

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

Requisitos

Requisito Valor
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]
Cabeçalho fwpmtypes.h

Confira também

Estruturas de API da Plataforma de Filtragem do Windows