WNetDisconnectDialog1A 函数（winnetwk.h）

项目
11/20/2024

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 标头将 WNetDisconnectDialog1 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winnetwk.h
库	Mpr.lib
DLL	Mpr.dll