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

Функция SHSetDefaultProperties (shobjidl.h)

  • Статья

Применяет набор свойств по умолчанию к элементу оболочки.

Синтаксис

SHSTDAPI SHSetDefaultProperties(
  [in, optional] HWND                       hwnd,
  [in]           IShellItem                 *psi,
                 DWORD                      dwFileOpFlags,
  [in, optional] IFileOperationProgressSink *pfops
);

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна элемента, который получает уведомления об ошибках. Это значение может иметь значение NULL.

[in] psi

Тип: IShellItem*

Указатель на объект IShellItem , представляющий элемент .

dwFileOpFlags

Тип: DWORD

Флаги, которые настраивают операцию. Значения флагов см. в разделе IFileOperation::SetOperationFlags .

[in, optional] pfops

Тип: IFileOperationProgressSink*

Указатель на объект IFileOperationProgressSink , используемый для отслеживание хода выполнения операции. Дополнительные сведения см. в разделе IFileOperation::Advise . Это значение может иметь значение NULL.

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

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Список свойств для задания значения по умолчанию поступает из записи реестра SetDefaultsFor в progID для сопоставления файлов элемента. Список имеет префикс "prop:" и содержит канонические имена свойств для задания значения по умолчанию, например "prop:System.Author;System.Document.DateCreated". Возможные свойства этого списка: System.Author, System.Document.DateCreated и System.Photo.DateTaken. Если запись SetDefaultsFor не существует в ProgID, эта функция использует значение по умолчанию, указанное в записи SetDefaultsForHKEY_CLASSES_ROOT\*.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl.h
Библиотека Shell32.lib
DLL Shell32.dll