Метод IFileSaveDialog::ApplyProperties (shobjidl_core.h)

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

Синтаксис

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

Параметры

[in] psi

Тип: IShellItem*

Указатель на элемент IShellItem , представляющий сохраняемый файл. Обычно это элемент, полученный getResult.

[in] pStore

Тип: IPropertyStore*

Указатель на IPropertyStore , представляющий значения свойств, применяемые к файлу. Это может быть хранилище свойств, возвращенное IFileSaveDialog::GetProperties.

[in] hwnd

Тип: HWND

Дескриптор окна приложения.

[in] pSink

Тип: IFileOperationProgressSink*

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

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

Тип: HRESULT

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

Комментарии

Этот метод следует использовать, если приложение включило коллекцию свойств (IFileSaveDialog::SetCollectedProperties), но не сохраняет сами свойства в сохраненном файле.

Примечание Файл, представленный элементом, указанным в psi , должен существовать в физическом хранилище перед вызовом IFileSaveDialog::ApplyProperties, поэтому в какой-то момент он должен быть сохранен.
 

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h