FwpsQueryPacketInjectionState0 함수(fwpsk.h)

  • 아티클

FwpsQueryPacketInjectionState0 함수는 설명선에 의해 호출되어 패킷 데이터의 삽입 상태를 쿼리합니다.

참고FwpsQueryPacketInjectionState0 은 FwpsQueryPacketInjectionState의 특정 버전입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.
 

구문

FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
  [in]            HANDLE                injectionHandle,
  [in]            const NET_BUFFER_LIST *netBufferList,
  [out, optional] HANDLE                *injectionContext
);

매개 변수

[in] injectionHandle

에 대한 호출로 이전에 만든 삽입 핸들 FwpsInjectionHandleCreate0 함수입니다.

[in] netBufferList

분류되는 패킷 데이터를 설명하는 NET_BUFFER_LIST 구조체에 대한 포인터입니다. 패킷은 네트워크 스택에서 시작되거나 WFP 콜아웃 드라이버에 의해 네트워크 스택에 삽입될 수 있습니다.

[out, optional] injectionContext

삽입 컨텍스트에 대한 선택적 핸들입니다. 포인터를 지정하고 삽입 핸들과 연결된 패킷 삽입 상태 FWPS_PACKET_INJECTION_STATE FWPS_PACKET_INJECTED_BY_SELF 또는 FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF 경우 패킷을 삽입할 때 제공된 삽입 컨텍스트가 반환됩니다.

반환 값

FwpsQueryPacketInjectionState0 함수는 FWPS_PACKET_INJECTION_STATE 열거형의 상수 값 중 하나를 반환합니다.

설명

삽입된 패킷 데이터는 삽입된 설명선에 대해 재분류할 수 있으므로 이 함수를 사용하면 필요한 경우 설명선에서 패킷 데이터의 삽입 기록을 검사할 수 있으므로 이미 검사된 패킷 데이터를 반복적으로 검사할 필요가 없습니다.

설명선은 패킷 데이터 주입 시 패킷 삽입 함수 중 하나에서 선택적 injectionContext 핸들을 지정하여 다른 설명선 관련 정보를 추적할 수 있습니다. FwpsQueryPacketInjectionState0 함수가 FWPS_PACKET_INJECTED_BY_SELF 또는 FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF 반환하는 경우 제공된 injectionContext는 삽입을 수행한 함수의 completionContext 매개 변수로 반환됩니다.

반환 값이 FWPS_PACKET_INJECTED_BY_SELF 또는 FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF 경우 netBufferList 가 가리키는 네트워크 버퍼 목록을 복제 및 삽입 절차의 일부로 추가로 수정하거나 보류하면 안 됩니다. 이 경우 설명선은 classifyFn 함수의 classifyOut 매개 변수가 가리키는 FWPS_CLASSIFY_OUT0 구조체의 actionType 멤버를 FWP_ACTION_CONTINUE 또는 FWP_ACTION_PERMIT 설정해야 합니다. 이렇게 하면 패킷이 다음 설명선으로 진행할 수 있습니다.

요구 사항

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

추가 정보

FWPS_CLASSIFY_OUT0

FWPS_PACKET_INJECTION_STATE

FwpsInjectionHandleCreate0

NET_BUFFER_LIST

classifyFn