共用方式為

FwpsRedirectHandleCreate0 函式 (fwpsk.h)

  • 發行項

FwpsRedirectHandleCreate0 函式會建立連線重新導向函式可用來將連線重新導向至本機進程的句柄。 如需重新導向的詳細資訊，請參閱 使用 Bind 或 Connect 重新導向。

注意FwpsRedirectHandleCreate0 是特定版本的 FwpsRedirectHandleCreate。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。

 

語法

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

參數

providerGuid

提供者 GUID。

flags

保留的。 設定為零。

redirectHandle

接收句柄之變數的指標。

傳回值

FwpsRedirectHandleCreate0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼 Description
STATUS_SUCCESS
 已成功傳回重新導向句柄。 redirectHandle 參數指向的變數包含句柄。
其他狀態代碼
 發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpsRedirectHandleCreate0 函式，以建立可用來重新導向連線的句柄。

如需重新導向的詳細資訊，請參閱 使用 Bind 或 Connect 重新導向。

圖說文字驅動程式應該呼叫 FwpsRedirectHandleCreate0 一次，並快取句柄，以便重複使用句柄。

在應用層強制 (ALE) 連線重新導向圖說文字才能將連線重新導向至本機進程，它必須先取得具有 FwpsRedirectHandleCreate0 函式的重新導向句柄，並將句柄放在 FWPS_CONNECT_REQUEST0 結構中。 圖說文字會修改 ALE 連接重新導向層之 classifyFn 中的 結構。

在圖說驅動程式使用重新導向句柄完成之後，它必須呼叫 FwpsRedirectHandleDestroy0 函式來終結句柄。

規格需求

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

另請參閱

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn