FwpsNetBufferListRetrieveContext0 함수(fwpsk.h)

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

참고FwpsNetBufferListRetrieveContext0 은 특정 버전의 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