NetUseAdd 函式 (lmuse.h)

發行項
02/28/2024

NetUseAdd 函式會建立本機電腦與遠端伺服器之間的連線。您可以指定要連接的本機驅動器號或印表機裝置。如果您未指定本機驅動器號或印表機裝置，函式會向伺服器驗證用戶端，以供日後連線。

語法

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

參數

[in] servername

要執行此函式之電腦的 UNC 名稱。如果此參數為 NULL，則會使用本機電腦。如果指定的 UncServerName 參數是遠端電腦，則遠端電腦必須使用舊版遠端存取通訊協定機制支援遠端 RPC 呼叫。

如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

[in] LevelFlags

值，指定資料的信息層級。此參數可以是下列其中一個值。

值	意義
1	指定本機裝置與共用資源之間的連線相關信息。資訊包括連線狀態和類型。 Buf 參數是USE_INFO_1結構的指標。
2	指定本機裝置與共用資源之間的連線相關信息。資訊包括連線狀態和類型，以及用戶名稱和功能變數名稱。 Buf 參數是USE_INFO_2結構的指標。

[in] buf

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

[out] parm_err

傳回ERROR_INVALID_PARAMETER錯誤時，接收錯誤中信息結構之第一個成員索引的值指標。如果此參數為 NULL，則不會在錯誤時傳回索引。如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

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

如果函式失敗，則傳回值是系統錯誤碼。如需錯誤碼的清單，請參閱系統錯誤碼。

備註

您也可以使用 WNetAddConnection2 和 WNetAddConnection3 函式，將本機裝置重新導向至網路資源。

呼叫 NetUseAdd 函式不需要特殊群組成員資格。此函式無法在遠端伺服器上執行，但發生下層相容性的情況除外。

此函式僅適用於伺服器消息塊 (LAN Manager 工作站) 用戶端。 NetUseAdd 函式不支援分散式文件系統 (DFS) 共用。若要使用不同的網路提供者來新增共用， (WebDAV 或 DFS 共用，例如) ，請使用 WNetAddConnection2 或 WNetAddConnection3 函式。

如果 NetUseAdd 函式傳回ERROR_INVALID_PARAMETER，您可以使用 ParmError 參數來指出無效信息結構的第一個成員。 (信息結構開頭為 USE_INFO_，而且其格式是由 Level 參數所指定。) 下表列出可在 ParmError 參數中傳回的值，以及發生錯誤的對應結構成員。 (前置詞 ui*_ 表示成員可以以多個前置詞開頭，例如，ui1_或 ui2_.)

常數	值	成員
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	lmuse.h (包括 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll