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


Метод IDiscRecorder::SetRecorderProperties (imapi.h)

Принимает указатель IPropertyStorage для объекта со всеми свойствами, которые приложение хочет изменить. Поддерживаются разреженные параметры. Однако рекомендуется запрашивать набор свойств с помощью GetRecorderProperties, изменять только интересующие параметры, а затем вызывать Метод SetRecorderProperties , чтобы изменить все значения одновременно.

Синтаксис

HRESULT SetRecorderProperties(
  [in] IPropertyStorage *pPropStg
);

Параметры

[in] pPropStg

Указатель на интерфейс IPropertyStorage , который средство записи дисков может использовать для получения новых параметров для различных свойств.

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

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Комментарии

Некоторые свойства доступны только для чтения, например MaxWriteSpeed. Свойства только для чтения и неподдерживаемые свойства игнорируются без возникновения ошибки (см. IMAPI_S_PROPERTIESIGNORED). Например, кто-то может отправить свойство, заданное в этом интерфейсе, и попытаться изменить свойства MaxWriteSpeed и ClearlyNeverHeardOfBefore. Так как Параметр MaxWriteSpeed доступен только для чтения, а ClearlyNeverHeardOfBefore — неизвестное значение, оба свойства игнорируются, и метод завершается успешно.

После вызова SetRecorderProperties приложение должно проверить параметры свойств, вызвав Метод GetRecorderProperties.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi.h
Библиотека Uuid.lib
DLL Actxprxy.dll

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

IDiscRecorder