Función FwpsClassifyOptionSet0 (fwpsk.h)

2025-02-07

La función FwpsClassifyOptionSet0 llama a la función de un filtro de llamada para clasificarFn para especificar información adicional que afecta a las características de las operaciones de filtrado permitidas.

NotafwpsClassifyOptionSet0 es una versión específica de FwpsClassifyOptionSet. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Sintaxis

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

Puntero a una estructura FWPS_INCOMING_METADATA_VALUES0. Esta estructura contiene los valores de cada uno de los campos de metadatos en la capa que se está filtrando.

[in] option

Constante de enumeración FWP_CLASSIFY_OPTION_TYPE que indica si el parámetro newValue hace referencia a estados de asignación de origen flexible, multidifusión o unidifusión, o a valores de tiempo de espera de datos. Para obtener más información, vea Comentarios.

[in] newValue

Puntero a una matriz de estructuras de FWP_VALUE0. Cada estructura de la matriz contiene valores concretos para una constante FWP_OPTION_VALUE_XXX determinada. Para obtener más información, vea Comentarios.

Valor devuelto

La función FwpsClassifyOptionSet0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	La función se completó correctamente.
STATUS_FWP_INVALID_ENUMERATOR	La opción parámetro no coincide con ninguno de los valores de . FWP_CLASSIFY_OPTION_TYPE enumeración.
STATUS_FWP_OUT_OF_BOUNDS	El valor de opción especificado por newValue -> uint32 no incluye uno de los valores constantes de FWP_OPTION_VALUE_XXX definidos.
STATUS_OBJECT_TYPE_MISMATCH	El tipo de datos especificado por newValue -> Type no se FWP_UINT32.
STATUS_UNSUCCESSFUL	Error general.
otros códigos de estado	Error.

Observaciones

Solo se debe llamar a esta función mediante la función de clasifiqueFn de un filtro de llamada.

A continuación se muestran los valores permitidos de la opción parámetro y miembros de la estructura de FWP_VALUE0 a la que apunta el parámetro newValue.

opción parámetro	newValue:>tipo Value	newValue:>valor uint32
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Habilite la asignación de origen flexible. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Deshabilite la asignación de origen flexible.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Permitir la creación del estado de multidifusión local de vínculo en el tráfico saliente. FWP_OPTION_VALUE_DENY_MULTICAST_STATE No permita la creación del estado de multidifusión local de vínculo en el tráfico saliente. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Permitir la creación de estado de multidifusión para el tráfico saliente (permitir respuestas locales que no son de vínculo).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Especifica la duración del estado de multidifusión o difusión, en segundos.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Especifica la duración del estado de unidifusión, en segundos.

El primer llamador (peso más alto) para establecer una opción determinada se le concederá esa opción. Por ejemplo, si la llamada A establece la opción de estado de multidifusión, la llamada B no podrá hacerlo, pero la llamada B puede establecer otras opciones.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
biblioteca de	Fwpkclnt.lib
irQL	<= DISPATCH_LEVEL