共用方式為

NetWkstaTransportAdd 函式 (lmwksta.h)

  • 發行項

[此函式已過時。 若要手動變更傳輸通訊協定的預設設定，請使用 [網路和撥號連線] 資料夾中的 [區域網路屬性] 對話方塊。

不支援。

NetWkstaTransportAdd函式會系結 (，或將) 重新導向器連接到傳輸。 重新導向器是用戶端電腦上的軟體，可產生伺服器電腦的檔案要求。

語法

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

參數

[in] servername

字串的指標，指定函式執行所在遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null，則會使用本機電腦。

這個字串的開頭必須是 \。

[in] level

指定資料的資訊層級。 此參數可以是下列值。

值 意義
0
 指定工作站傳輸通訊協定資訊。 buf參數指向WKSTA_TRANSPORT_INFO_0結構。

[in] buf

指定資料的緩衝區指標。 此資料的格式取決於 level 參數的值。 如需詳細資訊，請參閱 網路管理功能緩衝區。

[out] parm_err

值指標，這個值會接收造成ERROR_INVALID_PARAMETER錯誤之第一個參數的索引。 如果此參數為 Null，則不會在錯誤時傳回索引。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼 描述
ERROR_ACCESS_DENIED
 使用者無法存取要求的資訊。
ERROR_INVALID_LEVEL
 level 參數，指出可用的資料結構資訊層級無效。
ERROR_INVALID_PARAMETER
 其中一個函式參數無效。

備註

只有 Administrators 本機群組的成員才能成功執行 NetWkstaTransportAdd 函式 。

如果 NetWkstaTransportAdd 函式傳回ERROR_INVALID_PARAMETER，您可以使用 parm_err 參數來指出無效 WKSTA_TRANSPORT_INFO_0 結構的成員。 下表列出可在 parm_err 參數中傳回的值，以及發生錯誤的對應結構成員。

值 成員
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

需求

   
目標平台 Windows
標頭 lmwksta.h (包括 Lm.h、Lmwksta.h)
程式庫 Netapi32.lib
Dll Netapi32.dll