Función FwpsClassifyOptionSet0 (fwpsk.h)

Artículo
08/07/2023

La función classifyFn de un filtro de llamada llama a la función FwpsClassifyOptionSet0 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. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

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 la sección 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 la sección Comentarios.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	Si se devuelve este valor, significa que la función se completó correctamente.
STATUS_FWP_INVALID_ENUMERATOR	El parámetro option 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 de constante definidos FWP_OPTION_VALUE_XXX.
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	Se produjo un error.

Comentarios

La función classifyFn de un filtro de llamada solo debe llamar a esta función.

A continuación se muestran los valores permitidos del parámetro de opción y los miembros de la estructura 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 de estado de multidifusión local de vínculo en el tráfico saliente. FWP_OPTION_VALUE_DENY_MULTICAST_STATE No permita la creación de 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 (lo que permite 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 autor de llamada (mayor peso) 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	Value
Cliente mínimo compatible	Disponible a partir de Windows Vista.
Plataforma de destino	Universal
Encabezado	fwpsk.h (incluya Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL