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

要求

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

另请参阅

DISCDLGSTRUCT

WNetConnectionDialog

WNetConnectionDialog1

WNetDisconnectDialog

Windows 网络 (WNet) 概述

Windows 网络函数