FwpsRedirectHandleCreate0 函式（fwpsk.h）

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

NoteFwpsRedirectHandleCreate0 是 FwpsRedirectHandleCreate 的特定版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

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

providerGuid

提供者 GUID。

flags

保留。設定為零。

redirectHandle

接收句柄之變數的指標。

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

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

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

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

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

在應用層強制（ALE）連線重新導向圖說文字可以將連線重新導向至本機進程之前，它必須先使用 FwpsRedirectHandleCreate0 函式取得重新導向句柄，並將句柄放在 FWPS_CONNECT_REQUEST0 結構中。圖說文字會修改 ALE 連線重新導向層分類Fn 中的結構。

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