Свойства объекта
Переносные устройства 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 | Непрозрачная строка, созданная клиентом для сохранения состояния между сеансами без сохранения каталога содержимого подключенного устройства. |
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по