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

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

  • Статья

Метод GetValue получает текущее значение свойства устройства.

Синтаксис

HRESULT GetValue(
  [out] void  *pvValue,
        DWORD *pcbValue
);

Параметры

[out] pvValue

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

pcbValue

[inout] Указатель на переменную DWORD , которая указывает размер значения свойства в байтах. В записи *pcbValue содержит размер буфера, выделенного вызывающим объектом (или 0, если pvValue имеет значение NULL). Перед возвратом метод записывает фактический размер значения свойства, записанного в буфер (или требуемый размер, если буфер слишком мал или если значение pvValue равно NULL).

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

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

Код возврата Описание
E_POINTER
 Указатель pcbValue имеет значение NULL.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 Буфер, на который указывает параметр pvValue , слишком мал, чтобы содержать значение свойства, или значение pvValue равно NULL , а размер значения свойства является фиксированным, а не переменным. Дополнительные сведения об этом макросе см. в документации по Windows SDK.

Комментарии

Если размер значения свойства является переменным, а не фиксированным, вызывающий объект может получить требуемый размер буфера, вызвав Метод GetValue с параметром pvValue = NULL и *pcbValue = 0. Метод записывает требуемый размер буфера в *pcbValue. Используя эти сведения, вызывающий объект может выделить буфер требуемого размера и вызвать GetValue во второй раз, чтобы получить значение свойства.

Если буфер, выделенный вызывающим объектом, слишком мал для хранения значения свойства, GetValue записывает требуемый размер буфера в *pcbValue и возвращает код состояния ошибки. В этом случае он ничего не записывает в буфер, на который указывает pvValue.

Требования

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

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

Интерфейс IDeviceSpecificProperty