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

Функция PSRegisterPropertySchema (propsys.h)

Сообщает подсистеме схемы о добавлении файла схемы описания свойства.

Синтаксис

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Параметры

[in] pszPath

Тип: PCWSTR

Указатель на полный путь к файлу в виде строки Юникода на файл схемы описания свойства (.propdesc) на локальном компьютере. Это может быть либо полностью заданный полный путь, либо полный путь, включающий переменные среды, такие как %PROGRAMFILES%.

Возвращаемое значение

Тип: HRESULT

Возвращает одно из следующих значений.

Код возврата Описание
S_OK
 Все описания свойств в схеме зарегистрированы.
E_ACCESSDENIED
 Контекст вызова не имеет соответствующих привилегий.
INPLACE_S_TRUNCATED
 Не удалось зарегистрировать одно или несколько описаний свойств в схеме. Конкретные сбои регистрируются в журнале событий приложения.

Комментарии

Эта функция представляет собой API-оболочку для реализации подсистемы схемы IPropertySystem::RegisterPropertySchema. Вызывайте эту функцию только в том случае, если файл впервые установлен на компьютере. Как правило, приложение установки вызывает эту функцию после установки PROPDESC-файла, который должен храниться в каталоге установки приложения в разделе Program Files. Для регистрации нескольких файлов схемы в IPropertySystem::RegisterPropertySchema можно выполнить несколько вызовов.

При регистрации файлов схемы свойств помните, что они могут считываться процессами, выполняющимися от имени разных пользователей. Поэтому важно разместить файл схемы в расположении, которое предоставляет доступ на чтение всем пользователям на компьютере. Аналогичным образом используйте абсолютный путь к файлу в параметре pszPath этой функции.

Примечание Так как схемы зависят от компьютера и не могут быть зарегистрированы для каждого отдельного пользователя, регистрация пути к файлу в профилях пользователей не поддерживается в Windows Vista.
 
При обнаружении полного или частичного сбоя, препятствующего загрузке описания свойства, причина записывается в журнал событий приложения. Эта функция завершается сбоем с E_ACCESSDENIED, если контекст вызова не имеет соответствующих привилегий, включая доступ на запись к HKEY_LOCAL_MACHINE. За получение привилегий с помощью механизмов контроля учетных записей (UAC) отвечает вызывающее приложение.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа Windows
Header propsys.h
Библиотека Propsys.lib
DLL Propsys.dll (версия 5.0 или более поздняя)
Распространяемые компоненты Windows Desktop Search (WDS) 3.0
  • Last updated on