DISCDLGSTRUCTA 結構 (winnetwk.h)

DISCDLGSTRUCT 結構用於 WNetDisconnectDialog1 函式中。 結構包含中斷連線嘗試的必要資訊。

語法

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

成員

cbStructure

類型： DWORD

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

hwndOwner

類型： HWND

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

lpLocalName

類型： LPTSTR

NULL 終止字串的指標，指定重新導向至網络資源的本機裝置名稱，例如 “F：” 或 “LPT1”。

lpRemoteName

類型： LPTSTR

NULL 終止字串的指標，指定要中斷連線的網路資源名稱。 如果指定 lpLocalName 成員，這個成員可以是 NULL。 指定 lpLocalName 時，會中斷從 lpLocalName 重新導向之網路資源的連線。

dwFlags

類型： DWORD

描述連接的一組位旗標。 這個成員可以是下列值的組合。

值	意義
DISC_UPDATE_PROFILE	如果已設定此值，則每次使用者登入) 時，指定的連接不再是自動還原的持續性連線 (。 只有當 lpLocalName 成員指定本機裝置時，此旗標才有效。
DISC_NO_FORCE	如果未設定此值，當嘗試中斷與網路資源的連線時，系統會強制執行。 當使用者透過連線開啟檔案時，通常會發生這種狀況。 這個值表示使用者會在連線上有開啟的檔案時收到通知，並詢問他是否仍想要中斷連線。 如果使用者想要繼續，中斷連線程式會以額外的強制重新嘗試。

備註

注意

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

規格需求

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

另請參閱

WNetDisconnectDialog1

Windows 網路 (WNet) 概觀

Windows 網路結構