IItemNameLimits：：GetValidCharacters 方法 (shobjidl_core.h)

  • 项目

加载一个字符串，该字符串包含在调用它的命名空间中有效或无效的每个字符。

语法

HRESULT GetValidCharacters(
  [out] LPWSTR *ppwszValidChars,
  [out] LPWSTR *ppwszInvalidChars
);

参数

[out] ppwszValidChars

类型： LPWSTR*

指向包含命名空间中所有有效字符的字符串的指针。 如果命名空间在 ppwszInvalidChars 中提供了任何无效字符，则此值返回 NULL。 有关更多详细信息，请参阅“备注”。

[out] ppwszInvalidChars

类型： LPWSTR*

指向包含命名空间中所有无效字符的字符串的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

例如，标准文件系统返回字符串“/:*？”<>|”在 ppwszInvalidChars 中，在 ppwszValidChars 中为 NULL。

这两个参数都无法返回非 NULL 值，因此，由于非 NULL 值，为 ppwszValidChars 分配了 NULL 值

在 ppwszInvalidChars 中。 假定存在指定的无效字符时，其他所有字符都有效。 仅当 ppwszInvalidChars 为 NULL 时 ，ppwszValidChars 才会包含所有有效字符的列表。

如果方法返回成功代码，则必须使用 CoTaskMemFree 释放分配的字符串。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll