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