FwpsQueryConnectionSioFormatRedirectRecords0 함수(fwpsk.h)
FwpsQueryConnectionSioFormatRedirectRecords0 함수는 리디렉션된 연결에 대한 연결 리디렉션 레코드를 반환합니다. 리디렉션에 대한 자세한 내용은 바인딩 또는 연결 리디렉션 사용을 참조하세요.
구문
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 값을 반환합니다.
반환 코드 | 설명 |
---|---|
|
출력 버퍼가 너무 작아서 전송할 모든 바이트를 포함할 수 없습니다. 데이터 전송에 실패했으며 필요한 버퍼 크기는 BytesTransferred 매개 변수에서 찾을 수 있습니다. |
|
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 |
추가 정보
SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS(SDK)
WDK(SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS)
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS(SDK)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기