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

Метод IDeviceSpecificProperty::SetValue (devicetopology.h)

  • Статья

Метод SetValue задает значение свойства устройства.

Синтаксис

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

Параметры

[in] pvValue

Указатель на новое значение для свойства, относящееся к конкретному устройству.

[in] cbValue

Размер в байтах значения свойства для конкретного устройства.

[in] pguidEventContext

Контекстное значение для метода IControlChangeNotify::OnNotify . Этот параметр указывает на GUID контекста события. Если вызов SetValue изменяет состояние элемента управления, все клиенты, которые зарегистрировали IControlChangeNotify , будут получать уведомления. В реализации метода OnNotify клиент может проверить GUID контекста события, чтобы определить, является ли он или другой клиент источником события изменения элемента управления. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .

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

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

Код возврата Описание
E_POINTER
 Указатель pvValue имеет значение NULL.
E_INVALIDARG
 Параметр cbValue не соответствует требуемому размеру значения свойства.
E_OUTOFMEMORY
 Недостаточно памяти.

Требования

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

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

Интерфейс IDeviceSpecificProperty