WNetConnectionDialog1A 函式 (winnetwk.h)

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

語法

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

[in, out] lpConnDlgStruct

CONNECTDLGSTRUCT結構的指標。結構會建立流覽對話方塊參數。

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

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

傳回碼	描述
ERROR_INVALID_PARAMETER	已設定CONNDLG_RO_PATH和 [CONNDLG_USE_MRU] 對話方塊選項。 (對話方塊選項是由CONNECTDLGSTRUCT結構的dwFlags成員所指定。) -或- 已設定CONNDLG_PERSIST和 [CONNDLG_NOT_PERSIST] 對話方塊選項。 -或- [CONNDLG_RO_PATH] 對話方塊選項已設定，且NETRESOURCE結構的lpRemoteName成員不會指向遠端網路。 (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 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。