Метод IPortableDeviceProperties::SetValues (portabledeviceapi.h)

Статья
08/25/2023

Метод SetValues добавляет или изменяет одно или несколько свойств для указанного объекта на устройстве.

Синтаксис

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

Параметры

[in] pszObjectID

Указатель на строку, завершающуюся нулевым значением, которая содержит идентификатор объекта для изменения. Чтобы указать устройство, используйте WPD_DEVICE_OBJECT_ID.

[in] pValues

Указатель на интерфейс IPortableDeviceValues , содержащий одну или несколько пар "свойство-значение" для задания. Существующие значения будут перезаписаны.

[out] ppResults

Адрес переменной, получающей указатель на интерфейс IPortableDeviceValues , содержащий коллекцию значений property/HRESULT. Каждое значение (тип VT_ERROR) описывает успешное или неудачное выполнение попытки установки свойств. Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Обновлены все указанные значения свойств.
S_FALSE	Не удалось изменить одно или несколько свойств. Те, которые не могут иметь HRESULT типа VT_ERROR в полученном параметре ppResults .

Чтобы удалить свойство, вызовите метод IPortableDeviceProperties::D elete. Свойство можно удалить, только если его атрибут WPD_PROPERTY_ATTRIBUTE_CAN_WRITE имеет значение True. Этот атрибут можно получить, вызвав GetPropertyAttributes.