FwpsvSwitchEventsSubscribe0 함수(fwpsk.h)

FwpsvSwitchEventsSubscribe0 함수는 가상 포트 만들기 및 삭제와 같은 가상 스위치 계층 이벤트에 대한 콜백 진입점을 등록합니다.

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

 

통사론

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

매개 변수

providerGuid

공급자 GUID입니다.

notifyContext

설명선 드라이버 제공 컨텍스트에 대한 선택적 포인터입니다. 이벤트 알림 함수는 이 매개 변수를 드라이버에 다시 전달합니다.

flags

예약. 0으로 설정합니다.

reserved

예약. 0으로 설정합니다.

eventDispatchTable

가상 스위치 계층 이벤트에 대한 콜백 진입점을 정의하는 FWPS_VSWITCH_EVENT_DISPATCH_TABLE 구조체에 대한 포인터입니다.

subscriptionId

WFP가 구독에 할당하는 고유 식별자를 포함하는 변수에 대한 포인터입니다. 호출자는 FwpsvSwitchEventsUnsubscribe0 함수를 사용하여 WFP에 구독 식별자를 반환해야 합니다.

반환 값

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

반환 코드	묘사
STATUS_SUCCESS	분류 요청에 대한 핸들이 성공적으로 반환되었습니다. classifyHandle 매개 변수가 가리키는 변수는 분류 요청에 대한 핸들을 포함합니다.
기타 상태 코드	오류가 발생했습니다.

발언

설명선 드라이버는 FwpsvSwitchEventsSubscribe0 함수를 호출하여 가상 스위치 계층 이벤트에 대한 콜백 진입점을 등록합니다.

콜백 알림 함수의 진입점은 구조체에서 지정되고 FWPS_VSWITCH_EVENT_DISPATCH_TABLE0.

설명선 드라이버는 나중에 FwpsvSwitchEventsUnsubscribe0 호출하여 시스템 리소스를 해제해야 합니다.

요구 사항

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

참고 항목

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0