FwpsClassifyOptionSet0 함수(fwpsk.h)

아티클
02/07/2025

FwpsClassifyOptionSet0 함수는 설명선 필터의 classifyFn 함수에 의해 호출되어 허용된 필터링 작업의 특성에 영향을 주는 추가 정보를 지정합니다.

참고FwpsClassifyOptionSet0 특정 버전의 FwpsClassifyOptionSet. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상으로 지정을 참조하세요.

통사론

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

매개 변수

[in] inMetadataValues

FWPS_INCOMING_METADATA_VALUES0 구조체에 대한 포인터입니다. 이 구조에는 필터링되는 계층의 각 메타데이터 필드에 대한 값이 포함됩니다.

[in] option

newValue 매개 변수가 유니캐스트, 멀티캐스트 또는 느슨한 소스 매핑 상태를 참조하는지 또는 데이터 제한 시간 값을 참조하는지 여부를 나타내는 FWP_CLASSIFY_OPTION_TYPE 열거형 상수입니다. 자세한 내용은 비고를 참조하세요.

[in] newValue

FWP_VALUE0 구조체 배열에 대한 포인터입니다. 배열의 각 구조에는 특정 FWP_OPTION_VALUE_XXX 상수에 대한 특정 값이 포함됩니다. 자세한 내용은 비고를 참조하세요.

반환 값

FwpsClassifyOptionSet0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	묘사
STATUS_SUCCESS	함수가 성공적으로 완료되었습니다.
STATUS_FWP_INVALID_ENUMERATOR	옵션 매개 변수가 다음 값과 일치하지 않습니다. FWP_CLASSIFY_OPTION_TYPE 열거형입니다.
STATUS_FWP_OUT_OF_BOUNDS	newValue -> uint32 지정된 옵션 값에는 정의된 FWP_OPTION_VALUE_XXX 상수 값 중 하나가 포함되지 않습니다.
STATUS_OBJECT_TYPE_MISMATCH	newValue -> 형식 지정한 데이터 형식이 FWP_UINT32 않았습니다.
STATUS_UNSUCCESSFUL	일반적인 오류가 발생했습니다.
기타 상태 코드	오류가 발생했습니다.

발언

이 함수는 설명선 필터의 classifyFn 함수에서만 호출해야 합니다.

다음은 옵션 매개 변수의 허용되는 값과 newValue 매개 변수가 가리키는 FWP_VALUE0 구조체의 멤버입니다.

옵션 매개 변수	newValue->형식 값	newValue->uint32 값
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE 느슨한 소스 매핑을 사용하도록 설정합니다. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE 느슨한 소스 매핑을 사용하지 않도록 설정합니다.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE 아웃바운드 트래픽에서 링크-로컬 멀티캐스트 상태 생성을 허용합니다. FWP_OPTION_VALUE_DENY_MULTICAST_STATE 아웃바운드 트래픽에 대한 링크-로컬 멀티캐스트 상태 생성을 허용하지 않습니다. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE 아웃바운드 트래픽에 대한 멀티캐스트 상태 생성을 허용합니다(링크가 아닌 로컬 응답 허용).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	멀티캐스트/브로드캐스트 상태 수명(초)을 지정합니다.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	유니캐스트 상태 수명(초)을 지정합니다.

특정 옵션을 설정하는 첫 번째(가장 높은 가중치) 호출자에게 해당 옵션이 부여됩니다. 예를 들어 설명선 A가 멀티캐스트 상태 옵션을 설정하는 경우 설명선 B는 이 옵션을 설정할 수 없지만 설명선 B는 다른 옵션을 설정할 수 있습니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista부터 사용할 수 있습니다.
대상 플랫폼	보편적
헤더	fwpsk.h(Fwpsk.h 포함)
라이브러리	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL