Função FwpsClassifyOptionSet0 (fwpsk.h)

Artigo
02/07/2025

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

ObservaçãoFwpsClassifyOptionSet0 é uma versão específica do FwpsClassifyOptionSet. Consulte nomes de Version-Independent WFP e versões específicas de destino 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 refere-se a estados de mapeamento unicast, multicast ou de origem 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.

Valor de retorno

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	A opção parâmetro 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 pelo newValue -> Type não foi FWP_UINT32.
STATUS_UNSUCCESSFUL	Ocorreu um erro geral.
Outros códigos de status	Ocorreu um erro.

Observações

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

Veja a seguir os valores permitidos da opção parâmetro e membros da estrutura de FWP_VALUE0 apontados pelo parâmetro newValue.

opção Parameter	valor do tipo newValue->	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 de transmissão/multicast, 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
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	<= DISPATCH_LEVEL