WNetAddConnectionA 函式 (winnetwk.h)

發行項
08/27/2023

WNetAddConnection函式可讓呼叫的應用程式將本機裝置連線到網路資源。成功的連線是持續性的，這表示系統會在後續登入作業期間自動還原連線。

注意此函式僅適用于與 16 位版本的 Windows 相容。其他以 Windows 為基礎的應用程式應該呼叫 WNetAddConnection2 或 WNetAddConnection3 函式。

語法

DWORD WNetAddConnectionA(
  [in] LPCSTR lpRemoteName,
  [in] LPCSTR lpPassword,
  [in] LPCSTR lpLocalName
);

參數

[in] lpRemoteName

常 數 Null終止字串的指標，指定要連線的網路資源。

[in] lpPassword

常 數 Null終止字串的指標，指定要用來建立連接的密碼。此參數通常是與目前使用者相關聯的密碼。

如果此參數為 Null，則會使用預設密碼。如果字串是空的，則不會使用任何密碼。

Windows Me/98/95： 此參數必須是 Null 或空字串。

[in] lpLocalName

常 數 Null終止字串的指標，指定要重新導向之本機裝置的名稱，例如「F：」或「LPT1」。字串會以不區分大小寫的方式處理。如果字串為 Null，則會建立與網路資源的連線，而不重新導向本機裝置。

傳回值

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

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

傳回碼	描述
ERROR_ACCESS_DENIED	呼叫端無法存取網路資源。
ERROR_ALREADY_ASSIGNED	lpLocalName參數中指定的裝置已連線。
ERROR_BAD_DEV_TYPE	裝置類型和資源類型不符。
ERROR_BAD_DEVICE	在 lpLocalName參數中指定的值無效。
ERROR_BAD_NET_NAME	在 lpRemoteName參數中指定的值無效或無法找到。
ERROR_BAD_PROFILE	使用者設定檔的格式不正確。
ERROR_CANNOT_OPEN_PROFILE	系統無法開啟使用者設定檔來處理持續性連線。
ERROR_DEVICE_ALREADY_REMEMBERED	在 lpLocalName參數中指定的裝置專案已在使用者設定檔中。
ERROR_EXTENDED_ERROR	發生網路特定錯誤。若要取得錯誤的描述，請呼叫 WNetGetLastError 函式。
ERROR_INVALID_PASSWORD	指定的密碼無效。
ERROR_NO_NET_OR_BAD_PATH	無法執行作業，因為網路元件未啟動或無法使用指定的名稱。
ERROR_NO_NETWORK	網路無法使用。

備註

在 Windows Server 2003 和 Windows XP 上，WNet 函式會在與登入會話相關聯的 MS-DOS 裝置命名空間中建立和刪除網路磁碟機號，因為驗證識別碼 (
與登入會話相關聯的本機唯一識別碼或 LUID。) 這可能會影響呼叫其中一個 WNet 函式的應用程式，以在一個使用者登入下建立網路磁碟機號，但在不同的使用者登入下查詢現有的網路磁碟機號。這種情況的範例可能是當使用者的第二次登入是在登入會話內建立時，例如呼叫 CreateProcessAsUser 函式，而第二次登入會執行呼叫 GetLogicalDrives 函式的應用程式。 對 GetLogicalDrives 函式的呼叫不會傳回第一次登入下 WNet 函數呼叫所建立的網路磁碟機號。請注意，在上述範例中，第一個登入會話仍然存在，而且此範例可以套用至任何登入會話，包括終端機服務會話。如需詳細資訊，請參閱定義 MS-DOS 裝置名稱。

在 Windows Server 2003 和 Windows XP 上，如果以 LocalSystem 身分執行的服務會呼叫 WNetAddConnection 函式，則所有使用者登入會話都會看到對應的磁片磁碟機。

注意

winnetwk.h 標頭會將 WNetAddConnection 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winnetwk.h
程式庫	Mpr.lib
Dll	Mpr.dll