WNetConnectionDialog

【勇芳软件工作室】汉化HomePreviousNext

WNetConnectionDialog功能启动一个常规浏览对话框,用于连接到网络资源。

DWORD WNetConnectionDialog(

HWND 【HWND】,//窗口拥有对话框的句柄
DWORD 【dwType】//允许连接的资源类型
); 

参数

【HWND】

标识所属窗口。

【dwType】

指定允许连接的资源类型。该参数可以是以下值:

含义
RESOURCETYPE_DISK连接到磁盘资源。

返回值

如果函数成功,返回值为NO_ERROR。如果用户取消对话框,则为0xFFFFFFFF。

如果函数失败,则返回值是错误代码。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:

含义
ERROR_EXTENDED_ERROR发生网络特定错误。要获取错误的描述,请使用WNetGetLastError功能。
ERROR_INVALID_PASSWORD指定的密码无效。
ERROR_NO_NETWORK没有网络。
ERROR_NOT_ENOUGH_MEMORY没有足够的内存启动对话框。

该函数返回与Windows 3.1版兼容的错误代码。为了与Win32 API的相容性,该函数还设置由GetLastError函数返回的错误码值。

备注

如果用户在对话框中选择“确定”,则当WNetConnectionDialog返回时,所请求的网络连接将被执行。

如果该函数尝试进行连接,并且提供程序返回消息ERROR_INVALID_PASSWORD,Windows将提示用户输入密码,并在另一次尝试中使用新密码进行连接。

也可以看看

WNetAddConnection2, WNetCancelConnection2, WNetDisconnectDialog, WNetGetLastError