SHStartNetConnectionDialogW 函数 (shlobj_core.h)

[SHStartNetConnectionDialog 可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

显示网络连接的常规浏览对话框。

语法

SHSTDAPI SHStartNetConnectionDialogW(
  [in, optional] HWND    hwnd,
  [in, optional] LPCWSTR pszRemoteName,
                 DWORD   dwType
);

参数

[in, optional] hwnd

类型：HWND

父窗口的句柄。

[in, optional] pszRemoteName

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串指定远程网络名称。 此值可以设置为 NULL。

dwType

类型：DWORD

包含一组标志的位域，这些标志标识对话框要查找的资源类型。 此值可以包含以下在 Winnetwk.h 中定义的值之一：

RESOURCETYPE_ANY (0x00000000)

所有资源

RESOURCETYPE_DISK (0x00000001)

磁盘资源

RESOURCETYPE_PRINT (0x00000002)

打印资源

返回值

类型： HRESULT

始终返回 S_OK。

注解

注意

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

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shlobj_core.h (包括 Shlobj.h、Shlobj_core.h)
Library	Shell32.lib
DLL	Shell32.dll (5.0 或更高版本)