Compartir a través de


Función FwpsClassifyOptionSet0 (fwpsk.h)

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

Consulte también

FWPM_CLASSIFY_OPTION0

FWPM_CLASSIFY_OPTIONS0

FWPS_INCOMING_METADATA_VALUES0

FWP_CLASSIFY_OPTION_TYPE

FWP_VALUE0

classifyFn