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 释放分配的字符串。