FwpsQueryConnectionSioFormatRedirectRecords0 함수(fwpsk.h)

아티클
08/07/2023

FwpsQueryConnectionSioFormatRedirectRecords0 함수는 리디렉션된 연결에 대한 연결 리디렉션 레코드를 반환합니다. 리디렉션에 대한 자세한 내용은 바인딩 또는 연결 리디렉션 사용을 참조하세요.

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

구문

NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
  [in]            HANDLE  RedirectRecords,
  [out, optional] PVOID   OutputBuffer,
  [in]            SIZE_T  OutputBufferLength,
  [out, optional] PSIZE_T BytesTransferred
);

매개 변수

[in] RedirectRecords

리디렉션 레코드는 ALE_CONNECT_REDIRECT callout 함수가 classifyFn 함수의 inMetaValues 매개 변수에서 받은 것을 처리합니다. 이 핸들은 FWPS_INCOMING_METADATA_VALUES0 구조체의 redirectRecords 멤버에서 찾을 수 있습니다.

WFP 리디렉션 레코드는 리디렉션된 연결과 원래 연결이 논리적으로 관련되도록 WFP가 아웃바운드 프록시 연결에서 설정해야 하는 불투명 데이터의 버퍼입니다.

[out, optional] OutputBuffer

리디렉션 레코드를 수신하는 출력 버퍼에 대한 포인터입니다. 버퍼는 포인터 맞춤이어야 합니다.

[in] OutputBufferLength

출력 버퍼의 크기(바이트)입니다.

[out, optional] BytesTransferred

전송된 바이트 수를 수신하는 변수에 대한 포인터입니다. 반환 값이 STATUS_BUFFER_TOO_SMALL 경우 이 매개 변수는 필요한 버퍼 크기를 받습니다.

반환 값

다음 중 하나와 같은 NTSTATUS 값을 반환합니다.

반환 코드	설명
STATUS_BUFFER_TOO_SMALL	출력 버퍼가 너무 작아서 전송할 모든 바이트를 포함할 수 없습니다. 데이터 전송에 실패했으며 필요한 버퍼 크기는 BytesTransferred 매개 변수에서 찾을 수 있습니다.
STATUS_NOT_FOUND	RedirectRecords 매개 변수가 null입니다.

설명

FwpsQueryConnectionSioFormatRedirectRecords0 함수는 로컬 프록시에만 적용됩니다.

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

FwpsQueryConnectionSioFormatRedirectRecords0 함수는 실제 원격 엔드포인트에 연결할 수 있는지 확인할 때까지 리디렉션된 연결을 수락하지 않는 WFP 연결 리디렉션 설명선 드라이버에서 사용하도록 설계되었습니다. 이를 위해 설명선 드라이버는 FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 또는 FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 계층에서 리디렉션된 연결 요청을 보류하고 FwpsQueryConnectionSioFormatRedirectRecords0 을 호출하여 연결 리디렉션 레코드를 검색합니다. 그러면 설명선 드라이버가 SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS 호출에 사용할 프록시로 보냅니다.

요구 사항

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