Função FwpsClassifyOptionSet0 (fwpsk.h)

Artigo
02/29/2024

A função FwpsClassifyOptionSet0 é chamada pela função classifyFn de um filtro de texto explicativo para especificar informações adicionais que afetam as características das operações de filtragem permitidas.

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

Sintaxe

NTSTATUS FwpsClassifyOptionSet0(
  [in] const FWPS_INCOMING_METADATA_VALUES0 *inMetadataValues,
  [in] const FWP_CLASSIFY_OPTION_TYPE       option,
  [in] const FWP_VALUE0                     *newValue
);

Parâmetros

[in] inMetadataValues

Um ponteiro para uma estrutura FWPS_INCOMING_METADATA_VALUES0 . Essa estrutura contém os valores de cada um dos campos de metadados na camada que está sendo filtrada.

[in] option

Uma constante de enumeração FWP_CLASSIFY_OPTION_TYPE que indica se o parâmetro newValue se refere a estados de mapeamento de origem unicast, multicast ou flexível ou a valores de tempo limite de dados. Para obter mais informações, consulte Comentários.

[in] newValue

Um ponteiro para uma matriz de estruturas FWP_VALUE0 . Cada estrutura na matriz contém valores específicos para uma constante FWP_OPTION_VALUE_XXX específica. Para obter mais informações, consulte Comentários.

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	A função foi concluída com êxito.
STATUS_FWP_INVALID_ENUMERATOR	O parâmetro option não corresponde a nenhum dos valores no FWP_CLASSIFY_OPTION_TYPE enumeração.
STATUS_FWP_OUT_OF_BOUNDS	O valor da opção especificado por newValue -> uint32 não inclui um dos valores de constante FWP_OPTION_VALUE_XXX definidos.
STATUS_OBJECT_TYPE_MISMATCH	O tipo de dados especificado por newValue -> Type não foi FWP_UINT32.
STATUS_UNSUCCESSFUL	Ocorreu um erro geral.
Outros códigos de status	Ocorreu um erro.

Comentários

Essa função deve ser chamada apenas pela função classifyFn de um filtro de texto explicativo.

A seguir estão os valores permitidos do parâmetro option e membros da estrutura FWP_VALUE0 apontados pelo parâmetro newValue .

Opção Parâmetro	newValue->tipo Value	NewValue->valor uint32
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Habilite o mapeamento de origem flexível. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Desabilite o mapeamento de origem flexível.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Permitir a criação de estado multicast local de link no tráfego de saída. FWP_OPTION_VALUE_DENY_MULTICAST_STATE Não permita a criação de estado multicast local de link no tráfego de saída. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Permitir a criação de estado multicast para tráfego de saída (permitindo respostas não locais de link).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Especifica o tempo de vida do estado multicast/difusão, em segundos.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Especifica o tempo de vida do estado unicast, em segundos.

O primeiro chamador (de maior peso) a definir uma opção específica receberá essa opção. Por exemplo, se o texto explicativo A definir a opção de estado multicast, o texto explicativo B não poderá fazer isso, mas o texto explicativo B poderá definir outras opções.

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	<= DISPATCH_LEVEL