共用方式為

CONNECTDLGSTRUCTA 結構 （winnetwk.h）

  • 發行項

WNetConnectionDialog1 函式會使用 CONNECTDLGSTRUCT 結構來建立瀏覽對話框參數。

語法

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

成員

cbStructure

類型：DWORD

CONNECTDLGSTRUCT 結構的大小，以位元組為單位。 呼叫端必須提供此值。

hwndOwner

類型：HWND

對話框擁有者視窗的句柄。

lpConnRes

類型：LPNETRESOURCE

NETRESOURCE 結構的指標。

如果指定 NETRESOURCElpRemoteName 成員，則會輸入對話框的路徑字段。 除了 dwType 成員之外，NETRESOURCE 結構的其他所有成員都必須設定為 NULL。 dwType 成員必須等於 RESOURCETYPE_DISK。

系統不支援 RESOURCETYPE_PRINT 旗標來瀏覽及連線到列印資源。

dwFlags

類型：DWORD

描述對話框顯示選項的一組位旗標。 這個成員可以是下列值的組合。

價值 意義
SidTypeUser
 帳戶是用戶帳戶。
CONNDLG_RO_PATH
 顯示唯讀路徑，而不是允許使用者輸入路徑。

只有當 lpConn Res 所指向 NETRESOURCE 結構 成員的 lpRemoteName 成員不是 NULL 或空字符串，且未設定 CONNDLG_USE_MRU 旗標時，才應該設定此旗標。
CONNDLG_CONN_POINT
 內部旗標。 請勿使用。
CONNDLG_USE_MRU
 在組合方塊中輸入最近使用的路徑。 將此值設定為模擬 WNetConnectionDialog 函式。
CONNDLG_HIDE_BOX
 顯示複選框，允許使用者在登入時還原連線。
CONNDLG_PERSIST
 在登入時還原連線。
CONNDLG_NOT_PERSIST
 請勿在登入時還原連線。
 

如需詳細資訊，請參閱下列一節。

dwDevNum

類型：DWORD

如果呼叫 WNetConnectionDialog1 函式成功，則此成員會傳回已連線裝置的數目。 A：的值為 1，B：2 則為 3，C：則為 3，依此而定。 如果使用者建立無裝置連線，則值為 –1。

言論

如果未設定CONNDLG_RO_PATH或CONNDLG_USE_MRU旗標，而且 NETRESOURCE 結構 成員的 lpRemoteName 未指定遠端路徑，則要求預設為CONNDLG_RO_PATH對話框顯示類型。

無法同時設定CONNDLG_PERSIST和CONNDLG_NOT_PERSIST值。 如果兩者都未設定，對話框預設為此對話框中針對特定裝置連線類型選取的最後一個選項。

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 winnetwk.h

另請參閱

NETRESOURCE

WNetConnectionDialog1

Windows 網路功能 （WNet） 概觀

Windows 網路結構