WNetConnectionDialog1A 函式（winnetwk.h）

WNetConnectionDialog1 函式會顯示連線到網路資源的一般瀏覽對話方塊。函式需要 CONNECTDLGSTRUCT 來建立對話框參數。

語法

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

[in, out] lpConnDlgStruct

CONNECTDLGSTRUCT 結構的指標。結構會建立瀏覽對話參數。

如果使用者取消對話框，函式會傳回 –1。如果函式成功，則會傳回NO_ERROR。此外，如果呼叫成功，dwDevNumCONNECTDLGSTRUCT 結構的成員包含連線裝置的數目。

通常，只有當使用者無法輸入對話會話時，這個對話框才會傳回錯誤。這是因為對話會話之後發生的錯誤會直接回報給使用者。如果函式失敗，傳回值是系統錯誤碼，例如下列其中一個值。

傳回碼	描述
ERROR_INVALID_PARAMETER	設定CONNDLG_RO_PATH和 [CONNDLG_USE_MRU] 對話框選項。（對話框選項是由 CONNECTDLGSTRUCT 結構成員 dwFlags 所指定。 -或- 設定CONNDLG_PERSIST和 [CONNDLG_NOT_PERSIST] 對話框選項。 -或- [CONNDLG_RO_PATH] 對話框選項已設定，且 lpRemoteNameNETRESOURCE 結構的成員不會指向遠端網路。（CONNECTDLGSTRUCT 結構指向 NETRESOURCE 結構。
ERROR_BAD_DEV_TYPE	NETRESOURCE 結構的 dwType 成員未設定為 RESOURCETYPE_DISK。
ERROR_BUSY	網路提供者忙碌中（可能正在初始化）。呼叫端應該重試。
ERROR_NO_NETWORK	網路無法使用。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法顯示對話方塊。
ERROR_EXTENDED_ERROR	發生網路特定錯誤。呼叫 WNetGetLastError，以取得錯誤的描述。

注意

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

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winnetwk.h
連結庫	Mpr.lib
DLL	Mpr.dll