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

Метод IPortableDevicePropertiesBulk::QueueGetValuesByObjectList (portabledeviceapi.h)

  • Статья

Метод QueueGetValuesByObjectList помещает в очередь запрос на получение одного или нескольких указанных свойств от одного или нескольких указанных объектов на устройстве.

Синтаксис

HRESULT QueueGetValuesByObjectList(
  [in]  IPortableDevicePropVariantCollection  *pObjectIDs,
  [in]  IPortableDeviceKeyCollection          *pKeys,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);

Параметры

[in] pObjectIDs

Указатель на интерфейс IPortableDevicePropVariantCollection , который перечисляет идентификаторы объектов всех объектов для запроса. Они будут иметь тип VT_LPWSTR.

[in] pKeys

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

[in] pCallback

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

[out] pContext

Указатель на GUID, который используется для запуска, отмены или идентификации обратных вызовов IPortableDevicePropertiesBulkCallback , если они реализованы.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

Запрос в очереди не запускается до тех пор, пока приложение не вызовет Start. Дополнительные сведения об использовании этого метода см. в разделе Интерфейс IPortableDevicePropertiesBulk.

Из-за проблем с производительностью некоторые устройства могут не возвращать полный список свойств, если параметр pKeys имеет значение NULL.

Требования

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

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

Интерфейс IPortableDevicePropertiesBulk

IPortableDevicePropertiesBulk::QueueSetValuesByObjectList