Метод IPortableDeviceContent::CreateObjectWithPropertiesOnly (portabledeviceapi.h)

Статья
08/25/2023

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

Синтаксис

HRESULT CreateObjectWithPropertiesOnly(
            IPortableDeviceValues *pValues,
  [in, out] LPWSTR                *ppszObjectID
);

Параметры

pValues

Коллекция свойств IPortableDeviceValues, назначаемых объекту. Список обязательных и необязательных свойств объекта см. в разделе Требования для объектов.

[in, out] ppszObjectID

Необязательный строковый указатель для получения имени нового объекта. Может иметь значение NULL, если это не требуется. Переносимые устройства Windows определяют константные WPD_DEVICE_OBJECT_ID для представления устройства. Пакет SDK выделяет эту память; вызывающий объект должен освободить его с помощью CoTaskMemFree.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	По крайней мере один из обязательных аргументов был пустым указателем.

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

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

Фактически создаваемый драйвером объект может быть объектом свойств и данных в зависимости от того, какой тип объекта наиболее удобен для драйвера. Чтобы проверка, какой тип объекта создал драйвер, запросите свойство WPD_OBJECT_FORMAT нового объекта.

Объект будет создан на устройстве при возврате этого метода.

Примеры

Пример использования этого метода см. в разделе Передача объекта Properties-Only на устройство.

Требования

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

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

Интерфейс IPortableDeviceContent

Передача объекта Properties-Only на устройство

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