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

Метод IPortableDeviceManager::GetDeviceProperty (portabledeviceapi.h)

  • Статья

Извлекает значение свойства, хранящееся устройством на компьютере. (Это не стандартные свойства, определенные переносными устройствами Windows.)

Синтаксис

HRESULT GetDeviceProperty(
  [in]      LPCWSTR pszPnPDeviceID,
  [in]      LPCWSTR pszDevicePropertyName,
  [in, out] BYTE    *pData,
  [in, out] DWORD   *pcbData,
  [in, out] DWORD   *pdwType
);

Параметры

[in] pszPnPDeviceID

Указатель на строку, завершающуюся нулевым значением, которая содержит идентификатор Plug and Play устройства. Список Plug and Play имен всех устройств, подключенных к компьютеру, можно получить, вызвав Метод GetDevices.

[in] pszDevicePropertyName

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

[in, out] pData

Выделенный вызывающим объектом буфер для хранения полученных данных. Чтобы получить необходимый размер, вызовите этот метод с параметром NULL , а pcbData — равным нулю, и требуемый размер будет получен в pcbData. Этот вызов также возвращает ошибку, которую можно игнорировать. См. раздел Возвращаемые значения.

[in, out] pcbData

Размер буфера, выделенного или возвращаемого pData, в байтах.

[in, out] pdwType

Константа, описывающая тип данных, возвращаемых в pData. Значения этого параметра совпадают с типами, используемыми для описания параметра lpType функции RegQueryValueEx пакета SDK для платформы.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 Предоставленный буфер недостаточно велик для хранения запрошенных данных. (Этот результат всегда возвращается, если pData имеет значение NULL. Этот результат можно игнорировать, если вызывается метод для получения требуемого размера буфера. См. описание параметра pData .)
E_POINTER
 По крайней мере один из обязательных аргументов был указателем NULL .

Комментарии

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

Чтобы получить свойства переносимых устройств Windows из объекта устройства, вызовите метод IPortableDeviceProperties::GetValues и укажите объект устройства с помощью WPD_DEVICE_OBJECT_ID.

Требования

Требование Значение
Целевая платформа Windows
Header portabledeviceapi.h
Библиотека PortableDeviceGUIDs.lib

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

Интерфейс IPortableDeviceManager

IPortableDeviceManager::GetDevices