FwpsRedirectHandleCreate0 함수(fwpsk.h)
FwpsRedirectHandleCreate0 함수는 연결 리디렉션 함수가 연결을 로컬 프로세스로 리디렉션하는 데 사용할 수 있는 핸들을 만듭니다. 리디렉션에 대한 자세한 내용은 바인딩 또는 연결 리디렉션 사용을 참조하세요.
구문
NTSTATUS FwpsRedirectHandleCreate0(
const GUID *providerGuid,
UINT32 flags,
HANDLE *redirectHandle
);
매개 변수
providerGuid
공급자 GUID입니다.
flags
예약되어 있습니다. 0으로 설정됩니다.
redirectHandle
핸들을 수신하는 변수에 대한 포인터입니다.
반환 값
FwpsRedirectHandleCreate0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
리디렉션 핸들이 성공적으로 반환되었습니다. 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 |