피드백

FwpsNetBufferListRetrieveContext0 함수(fwpsk.h)

  • 아티클
  • 읽는 데 2분 걸림

FwpsNetBufferListRetrieveContext0 함수는 다른 계층에서 태그가 지정된 네트워크 버퍼 목록과 연결된 컨텍스트를 검색합니다.

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

구문

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

매개 변수

[in, out] netBufferList

설명선 드라이버에 대한 하나 이상의 관심 패킷을 나타내는 네트워크 버퍼 목록입니다. removeContext가 설정된 경우 반환된 네트워크 버퍼 목록에 컨텍스트가 제거됩니다.

[in] contextTag

FwpsNetBufferListGetTagForContext0 함수를 호출하여 가져온 로컬 고유 식별자입니다. FwpsNetBufferListAssociateContext0에 대한 초기 호출에 사용되는 컨텍스트 태그입니다.

[in] removeContext

설정된 경우 FwpsNetBufferListRetrieveContext0 은 컨텍스트 검색 외에 컨텍스트 연결을 제거합니다.

[in] flags

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정됩니다.

[out] context

FwpsNetBufferListAssociateContext0에 대한 초기 호출에서 설명선 드라이버가 패킷에 할당한 컨텍스트입니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 연결이 성공했습니다.
기타 상태 코드
 오류가 발생했습니다.

설명

FwpsNetBufferListRetrieveContext0 함수는 다른 계층에서 태그가 지정된 네트워크 버퍼 목록을 검색합니다.

이 함수를 사용하여 removeContext 매개 변수를 설정하여 컨텍스트 연결을 제거할 수도 있습니다.

요구 사항

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

참고 항목

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0

FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST