FwpsQueryConnectionSioFormatRedirectRecords0 函式 (fwpsk.h)

發行項
02/26/2024

FwpsQueryConnectionSioFormatRedirectRecords0 函式會傳回重新導向連線的連接重新導向記錄。如需重新導向的詳細資訊，請參閱使用系結或連線重新導向。

注意FwpsQueryConnectionSioFormatRedirectRecords0 是特定版本的 FwpsQueryConnectionSioFormatRedirectRecords。如需詳細資訊，請參閱 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在分類Fn 函式的 inMetaValues 參數中收到的圖說文字函式。您可以在 FWPS_INCOMING_METADATA_VALUES0 結構的 redirectRecords 成員中找到此句柄。

一個是一種不透明數據的緩衝區，在輸出 Proxy 連線上必須設定一個不透明數據，以便重新導向的連線和原始連接以邏輯方式相關。

[out, optional] OutputBuffer

接收重新導向記錄之輸出緩衝區的指標。緩衝區必須對齊指標。

[in] OutputBufferLength

輸出緩衝區的大小，以位元組為單位。

[out, optional] BytesTransferred

接收已傳送位元組數目之變數的指標。如果傳回值 STATUS_BUFFER_TOO_SMALL，此參數會收到必要的緩衝區大小。

傳回值

傳回NTSTATUS值，例如下列其中一個。

傳回碼	Description
STATUS_BUFFER_TOO_SMALL	輸出緩衝區太小，無法包含所有要傳輸的位元組。數據傳輸失敗，而且可以在 BytesTransferred 參數中找到所需的緩衝區大小。
STATUS_NOT_FOUND	RedirectRecords 參數為 null。

備註

FwpsQueryConnectionSioFormatRedirectRecords0 函式僅適用於本機 Proxy。

如需重新導向的詳細資訊，請參閱使用系結或連線重新導向。

FwpsQueryConnectionSioFormatRedirectRecords0 函式的設計目的是要供一個在確認它能夠連線到實際遠端端端點之前，接受重新導向聯機的圖說文字驅動程式使用。若要這樣做，圖說文字驅動程式會在 FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 或 FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 層傳送重新導向連線要求，並呼叫 FwpsQueryConnectionSioFormatRedirectRecords0 來擷取連線重新導向記錄，圖說文字驅動程式接著會將這些記錄傳送至 Proxy，以用於呼叫SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS。

規格需求

需求	值
最低支援的用戶端	Windows 7
最低支援的伺服器	Windows Server 2008 R2
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL