共用方式為

WNetRestoreConnectionW 函式 (winnetwk.h)

  • 發行項

[WNetRestoreConnectionW 不適用於 Windows Vista。]

WNetRestoreConnectionW 函式會還原與網路資源的連線。 函式會視需要提示使用者輸入名稱和密碼。

語法

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

參數

[in] hWnd

函式用來顯示使用者介面的父視窗句柄 (UI) ，提示使用者在進行網路連線時輸入名稱和密碼。 如果此參數為 NULL，則沒有擁有者視窗。

[in] lpDevice

Null 終止 Unicode 字串的指標，指定要連線的磁碟驅動器本機名稱，例如 “Z：”。 如果此參數為 NULL，函式會重新連線目前使用者登錄中儲存的所有永續性磁碟驅動器。

傳回值

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

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

傳回碼 Description
ERROR_ACCESS_DENIED
 呼叫端無法存取網路資源。
ERROR_ALREADY_ASSIGNED
 lpDevice 指定的本機裝置已連線到網路資源。
ERROR_BAD_DEV_TYPE
 本機裝置的類型和網路資源類型不符。
ERROR_BAD_DEVICE
 lpDevice 指定的值無效。
ERROR_BAD_PROFILE
 使用者配置檔的格式不正確。
ERROR_BUSY
 路由器或提供者忙碌中，可能正在初始化。 呼叫端應該重試。
ERROR_CANCELLED
 使用者透過其中一個網路資源提供者或所呼叫資源的對話框取消嘗試進行連線。
ERROR_CANNOT_OPEN_PROFILE
 系統無法開啟使用者配置檔來處理持續性連線。
ERROR_DEVICE_ALREADY_REMEMBERED
 裝置的項目已經在使用者配置檔中。
ERROR_EXTENDED_ERROR
 發生網路特定的錯誤。 呼叫 WNetGetLastError 函式以取得錯誤的描述。
ERROR_INVALID_PASSWORD
 指定的密碼無效。
ERROR_NO_NET_OR_BAD_PATH
 無法執行作業，因為網路元件未啟動，或是無法使用指定的名稱。
ERROR_NO_NETWORK
 網路無法使用。

備註

Windows Vista 和更新版本不支援 WNetRestoreConnectionW 函式。

若要呼叫此函式，請先呼叫 LoadLibrary 函式以載入 Mpr.dll。 然後呼叫 GetProcAddress 函式，以擷取 WNetRestoreConnectionW 函式的位址。

Winlogon 會使用 WNetRestoreConnectionW 在互動式登錄過程中還原所有持續性磁碟驅動器對應。 Microsoft Windows Shell 也會呼叫函式，以在使用者的要求重新連線個別磁碟驅動器。 例如，當磁碟驅動器無法在登入時重新連線，而使用者按兩下 [我的電腦] 虛擬資料夾下的磁碟驅動器時，可能會發生這種情況。

規格需求

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

另請參閱

Windows 網路 (WNet) 概觀

Windows 網路功能