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 結構的指標。

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

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

dwFlags

類型： DWORD

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

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

只有當 lpConnRes 成員所指向之 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，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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 winnetwk.h

另請參閱

NETRESOURCE

WNetConnectionDialog1

Windows 網路 (WNet) 概觀

Windows 網路結構