WNetDisconnectDialog1A 函式 (winnetwk.h)

WNetDisconnectDialog1函式會嘗試中斷網路資源的連線。如果基礎網路傳回ERROR_OPEN_FILES，函式會提示使用者確認。如果發生任何錯誤，函式會通知使用者。函式需要 DISCDLGSTRUCT 來指定中斷連線嘗試的參數。

語法

DWORD WNetDisconnectDialog1A(
  [in] LPDISCDLGSTRUCTA lpConnDlgStruct
);

[in] lpConnDlgStruct

DISCDLGSTRUCT結構的指標。結構會指定中斷連線嘗試的行為。

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

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

傳回碼	描述
ERROR_CANCELLED	當系統提示使用者決定中斷連線時，使用者選擇不要中斷連線。
ERROR_OPEN_FILES	無法中斷連線，因為使用者正主動使用連線。
ERROR_BUSY	網路提供者忙碌 (可能初始化) 。呼叫端應該重試。
ERROR_NO_NETWORK	網路無法使用。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法啟動對話方塊。
ERROR_EXTENDED_ERROR	發生網路特定的錯誤。呼叫 WNetGetLastError 函式以取得錯誤的描述。

注意

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