Метод IPropertySystem::RegisterPropertySchema (propsys.h)

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

Синтаксис

HRESULT RegisterPropertySchema(
  [in] LPCWSTR pszPath
);

Параметры

[in] pszPath

Тип: LPCWSTR

Указатель на путь к файлу PROPDESC на локальном компьютере.

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

Тип: HRESULT

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

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

Комментарии

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

Если обнаружен сбой, который не позволяет загрузить описание свойства, причина будет записана в журнал событий приложения. Этот метод завершается сбоем с E_ACCESSDENIED, если контекст вызова не имеет соответствующих привилегий, включая доступ на запись к HKLM (HKEY_LOCAL_MACHINE). За получение привилегий с помощью механизмов с ограниченной учетной записью пользователя (LUA) отвечает вызывающее приложение.

Требования

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

См. также раздел

IPropertySystem