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


Свойства объекта

Переносные устройства Windows поддерживают следующие свойства объекта.

Свойство VarType Описание
WPD_OBJECT_BACK_REFERENCES VT_UNKNOWN IPortableDevicePropVariantCollection типа VT_LPWSTR, указывающий список идентификаторов ObjectID. Если на объект ссылается объект контейнера, например звуковой объект, на который ссылается список воспроизведения, объект, на который указывает ссылка, использует это свойство для возврата к объекту контейнера. В этом примере звуковой объект может ссылаться на объект списка воспроизведения.
WPD_OBJECT_CAN_DELETE VT_BOOL Логическое значение, указывающее, можно ли удалить данный объект.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID VT_LPWSTR Идентификатор ближайшего функционального объекта, содержащего этот объект. Например, для файла внутри функционального объекта хранилища для этого свойства будет задан идентификатор функционального объекта хранилища.
WPD_OBJECT_CONTENT_TYPE VT_CLSID ИДЕНТИФИКАТОР GUID, определяющий универсальный тип этого объекта, например документ или сообщение электронной почты. Это может быть тип объекта, определенный переносимыми устройствами Windows, или настраиваемый тип содержимого драйвера. Объект устройства является единственным объектом, который не сообщает об этом свойстве.
WPD_OBJECT_DATE_AUTHORED VT_DATE Значение типа , указывающее дату и время создания содержимого. Это может не совпадать с датой создания файла. Например, у музыкального файла есть дата создания, когда была записана музыка, а дата создания — когда файл WMA был создан на устройстве.
WPD_OBJECT_DATE_CREATED VT_DATE Значение типа , указывающее дату и время создания объекта на устройстве.
WPD_OBJECT_DATE_MODIFIED VT_DATE Значение типа , указывающее дату и время изменения объекта на устройстве.
WPD_OBJECT_FORMAT VT_CLSID GUID, определяющий формат данных объекта. Это может быть формат, определенный переносимыми устройствами Windows , или пользовательский формат драйвера.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE VT_BOOL Логическое значение, указывающее, следует ли создавать эскиз для этого объекта из данных ресурса по умолчанию. Это позволяет объектам без ресурса эскизов обеспечить более понятный интерфейс просмотра. Использование этого флага может повлиять на первый ответ на отображение, так как приложение должно получить и вычислить эскиз с устройства; по возможности более эффективно предоставить отдельный ресурс эскизного изображения.
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME VT_LPWSTR Если заданный объект отображается как расположение подсказки, это свойство указывает отображаемое имя подсказки вместо имени объекта. Драйверы могут указывать указания расположения для различных типов контента. Их можно рассматривать как ярлыки для объектов папок верхнего уровня, содержащих объекты указанных типов. Клиенты, использующие эти указания о расположении, могут отображать имена этих ярлыков, отличные от имени объекта папки. Если это свойство не существует, обычно используется WPD_OBJECT_NAME .
WPD_OBJECT_ID VT_LPWSTR Строковый идентификатор, который однозначно идентифицирует объект на устройстве. Этот идентификатор не обязательно хранить в сеансах. Если это свойство является уникальным и постоянным, драйвер может задать для WPD_OBJECT_PERSISTENT_UNIQUE_ID и WPD_OBJECT_ID одно и то же значение.
WPD_OBJECT_IS_DRM_PROTECTED VT_BOOL Логическое значение, указывающее, защищены ли данные мультимедиа DRM. Если этот параметр отсутствует, предполагается, что он имеет значение False.
WPD_OBJECT_ISHIDDEN VT_BOOL Логическое значение, указывающее, должен ли объект быть скрыт. Если он отсутствует, предполагается, что объект не скрыт.
WPD_OBJECT_CAN_DELETE VT_BOOL Логическое значение, указывающее, можно ли удалить объект.
WPD_OBJECT_ISSYSTEM VT_BOOL Логическое значение, указывающее, представляет ли объект системные данные (например, системный файл). Если он отсутствует, предполагается, что объект не является системным объектом.
WPD_OBJECT_KEYWORDS VT_LPWSTR Строка, содержащая список ключевых слов с разделителями пробелами, связанных с этим объектом.
WPD_OBJECT_LANGUAGE_LOCALE VT_LPWSTR Строка, которая поменит язык, используемый заданным объектом. Если в этом объекте содержится несколько языков, он должен идентифицировать основной язык. Это свойство может содержать код языка, как определено в ISO-639, например : "en". Он также может содержать код страны языка, состоящий из двух или трех символов, как определено в стандарте ISO-639, за которым следует дефис, а затем код страны, как определено в ISO-3166, например: "en-US".
WPD_OBJECT_NAME VT_LPWSTR Отображаемое имя объекта.
WPD_OBJECT_NON_CONSUMABLE VT_BOOL Логическое значение, указывающее, должен ли этот объект быть понятен или просто сохранен устройством. Если этого свойства нет, предполагается, что все данные предназначены для использования.
WPD_OBJECT_ORIGINAL_FILE_NAME VT_LPWSTR Строковое имя файла.
WPD_OBJECT_PARENT_ID VT_LPWSTR Идентификатор родительского объекта. Единственный объект, который может вернуть пустую строку для этого значения, — это корневой объект устройства. Чтобы изменить это свойство, вызовите IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE).
WPD_OBJECT_PERSISTENT_UNIQUE_ID VT_LPWSTR Строковый идентификатор, который однозначно идентифицирует объект на устройстве, аналогично WPD_OBJECT_ID, но должен храниться в разных сеансах. Если идентификатор объекта WPD_OBJECT_ID является уникальным и постоянным, драйвер может задать одно и то же значение для WPD_OBJECT_PERSISTENT_UNIQUE_ID и WPD_OBJECT_ID .
WPD_OBJECT_REFERENCES VT_UNKNOWN IPortableDevicePropVariantCollection, содержащий коллекцию идентификаторов VT_LPWSTR объектов, определяющих объекты, на которые указывает ссылка. Это необходимо, только если объект является ссылочным объектом, например папкой или списком воспроизведения.
WPD_OBJECT_SIZE VT_UI8 Размер данных ресурса объекта.
WPD_OBJECT_SYNC_ID VT_LPWSTR Непрозрачная строка, созданная клиентом для сохранения состояния между сеансами без сохранения каталога содержимого подключенного устройства.

Требования

Требование Значение
Заголовок
PortableDevice.h

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

Свойства и атрибуты WPD