WNetConnectionDialog 函式 (winnetwk.h)

WNetConnectionDialog函式會啟動連線到網路資源的一般流覽對話方塊。函式需要對話方塊擁有者視窗的控制碼。

語法

DWORD WNetConnectionDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

[in] hwnd

對話方塊的擁有者視窗控制碼。

[in] dwType

允許連線的資源類型。此參數可以是下列值。

值	意義
RESOURCETYPE_DISK	磁片資源的連線。

如果函式成功，傳回值會NO_ERROR。如果使用者取消對話方塊，函式會傳回 –1。

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

傳回碼	描述
ERROR_EXTENDED_ERROR	發生網路特定的錯誤。若要取得錯誤的描述，請呼叫 WNetGetLastError 函式。
ERROR_INVALID_PASSWORD	指定的密碼無效。
ERROR_NO_NETWORK	網路無法使用。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法啟動對話方塊。

如果使用者按一下對話方塊中的 [ 確定 ]，當 WNetConnectionDialog 函式傳回時，就會進行要求的網路連線。

如果函式嘗試建立連線，而網路提供者傳回訊息ERROR_INVALID_PASSWORD，系統會提示使用者輸入密碼。系統會在另一次嘗試進行連線時使用新密碼。