Share via

FwpsRedirectHandleCreate0 함수(fwpsk.h)

  • 아티클

FwpsRedirectHandleCreate0 함수는 연결 리디렉션 함수가 연결을 로컬 프로세스로 리디렉션하는 데 사용할 수 있는 핸들을 만듭니다. 리디렉션에 대한 자세한 내용은 바인딩 또는 연결 리디렉션 사용을 참조하세요.

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

 

구문

NTSTATUS FwpsRedirectHandleCreate0(
  const GUID *providerGuid,
  UINT32     flags,
  HANDLE     *redirectHandle
);

매개 변수

providerGuid

공급자 GUID입니다.

flags

예약되어 있습니다. 0으로 설정됩니다.

redirectHandle

핸들을 수신하는 변수에 대한 포인터입니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 리디렉션 핸들이 성공적으로 반환되었습니다. redirectHandle 매개 변수가 가리키는 변수에 핸들이 포함됩니다.
기타 상태 코드
 오류가 발생했습니다.

설명

설명선 드라이버는 FwpsRedirectHandleCreate0 함수를 호출하여 연결을 리디렉션하는 데 사용할 수 있는 핸들을 만듭니다.

리디렉션에 대한 자세한 내용은 바인딩 또는 연결 리디렉션 사용을 참조하세요.

설명선 드라이버는 FwpsRedirectHandleCreate0을 한 번 호출하고 핸들을 캐시하여 핸들을 다시 사용할 수 있도록 해야 합니다.

ALE(애플리케이션 계층 적용) 연결 리디렉션 설명선이 로컬 프로세스로 연결을 리디렉션하려면 먼저 FwpsRedirectHandleCreate0 함수를 사용하여 리디렉션 핸들을 가져와서 FWPS_CONNECT_REQUEST0 구조에 핸들을 배치해야 합니다. 설명선은 ALE 연결 리디렉션 계층에 대한 classifyFn 의 구조를 수정합니다.

설명선 드라이버가 리디렉션 핸들 사용을 완료한 후 FwpsRedirectHandleDestroy0 함수를 호출하여 핸들을 삭제해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 유니버설
헤더 fwpsk.h(Fwpsk.h 포함)
라이브러리 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

추가 정보

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn