SHValidateUNC 函数 (shlobj_core.h)

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

通过调用 WNetAddConnection3 (UNC) 路径验证通用命名约定。通过函数，用户可以在“开始”菜单上的“运行”对话框中键入远程网络访问 (RNA) UNC 应用程序或文档名称。

语法

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

[in, optional] hwndOwner

类型：HWND

用于显示 UI 的父窗口的句柄。如果不需要此值，则可以将此值设置为 NULL。

[in, out] pszFile

类型： PWSTR

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定要验证的 UNC 路径。注意：此字符串不得为常量字符串。

fConnect

类型： UINT

以下一个或多个值。

连接驱动器号。设置此标志后， pszFile 中的值将更改为本地计算机上 UNC 映射到的本地驱动器。

在失败或成功时，不显示 UI。

验证为打印共享而不是磁盘共享。

Windows Vista 及更高版本。应使连接持久化。

用于验证传递给 SHValidateUNC 的标志是否有效的掩码值。

类型： BOOL

如果 UNC 路径存在，则返回 TRUE ;如果 UNC 路径不存在，或者发生其他一些故障，则为 FALSE 。