Поделиться через

Метод 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 и NULL в ppwszValidChars.

Оба параметра не могут возвращать значения, отличные от NULL , поэтому ppwszValidChars присваивается значение NULL из-за значения, отличного от NULL .

в ppwszInvalidChars. Предполагается, что при указании недопустимых символов все остальное является допустимым. Только если параметр ppwszInvalidChars имеет значение NULL , ppwszValidChars содержит список всех допустимых символов.

Если метод возвращает код успешного выполнения, выделенная строка должна быть освобождена с помощью CoTaskMemFree.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)
DLL Shell32.dll