Метод 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 |