Метод IWMDMDevice3::SetProperty (mswmdm.h)

Статья
03/05/2024

Метод SetProperty задает определенное свойство устройства, если оно доступно для записи.

Синтаксис

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

Параметры

[in] pwszPropName

Широкое символьное строковое имя задаемого свойства, заканчивающегося нулевым значением. При этом любое существующее свойство перезаписывается с тем же именем. После выполнения этого вызова приложение должно освободить динамическую память с помощью PropVariantClear. Список стандартных констант имен свойств приведен в разделе Константы метаданных.

[in] pValue

Значение устанавливаемого свойства.

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Этот метод задает указанное свойство устройства. Чтобы получить список поддерживаемых свойств устройства, клиент должен запросить метод IWMDMDevice3::GetProperty для свойства g_wszWMDMSupportedDeviceProperties .

Список имен свойств устройств см. в разделе Константы метаданных.

Этот метод аналогичен методу SetMetadata для хранилищ, но он может одновременно задать только одно свойство.

Не все свойства устройства можно задать.