Compartilhar via


Propriedades de objeto

Os Dispositivos Portáteis do Windows dão suporte às propriedades de objeto a seguir.

Propriedade VarType Descrição
WPD_OBJECT_BACK_REFERENCES VT_UNKNOWN Um IPortableDevicePropVariantCollection do tipo VT_LPWSTR indicando uma lista de ObjectIDs. Quando um objeto é referenciado por um objeto de contêiner, por exemplo, um objeto de áudio referenciado por uma playlist, o objeto referenciado usa essa propriedade para fazer referência ao objeto contêiner. O objeto de áudio pode fazer referência ao objeto de playlist neste exemplo.
WPD_OBJECT_CAN_DELETE VT_BOOL Um valor booliano que especifica se o objeto determinado pode ser excluído.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID VT_LPWSTR A ID do objeto funcional mais próximo que contém esse objeto. Por exemplo, um arquivo dentro de um objeto funcional de armazenamento terá essa propriedade definida como a ID do objeto funcional de armazenamento.
WPD_OBJECT_CONTENT_TYPE VT_CLSID Um GUID que identifica o tipo genérico desse objeto, por exemplo, um documento ou email. Pode ser um tipo de objeto definido por Dispositivos Portáteis do Windows ou um tipo de conteúdo de driver personalizado. O objeto de dispositivo é o único objeto que não relata essa propriedade.
WPD_OBJECT_DATE_AUTHORED VT_DATE Um valor que especifica a data e a hora em que o conteúdo foi criado. Isso pode não ser o mesmo que a data de criação do arquivo. Por exemplo, um arquivo de música tem uma data de criação de quando a música foi gravada, mas uma data de criação de quando o arquivo WMA foi realmente criado no dispositivo.
WPD_OBJECT_DATE_CREATED VT_DATE Um valor que especifica a data e a hora em que o objeto foi criado no dispositivo.
WPD_OBJECT_DATE_MODIFIED VT_DATE Um valor que especifica a data e a hora em que o objeto foi modificado no dispositivo.
WPD_OBJECT_FORMAT VT_CLSID Um GUID que identifica o formato dos dados do objeto. Pode ser um formato definido por Dispositivos Portáteis do Windows ou um formato de driver personalizado.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE VT_BOOL Um valor booliano que especifica se a imagem em miniatura desse objeto deve ser criada com base nos dados de recurso padrão. Isso fornece uma maneira de objetos sem um recurso de miniatura fornecer uma experiência de navegação mais amigável. O uso desse sinalizador pode afetar a primeira resposta de exibição, pois o aplicativo deve recuperar e calcular uma imagem em miniatura do dispositivo; é mais eficiente fornecer um recurso de imagem em miniatura separado, se possível.
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME VT_LPWSTR Se o objeto fornecido aparecer como um local de dica, essa propriedade indicará o nome específico da dica a ser exibido em vez do nome do objeto. Os drivers podem especificar dicas de localização para vários tipos de conteúdo. Eles podem ser considerados atalhos para objetos de pasta de nível superior que contêm objetos dos tipos especificados. Os clientes que usam essas dicas de localização podem exibir um nome para esses atalhos que diferem do nome do objeto da pasta. Se essa propriedade não existir, o WPD_OBJECT_NAME normalmente será usado.
WPD_OBJECT_ID VT_LPWSTR Uma ID de cadeia de caracteres que identifica exclusivamente o objeto no dispositivo. Essa ID não precisa ser armazenada entre sessões. Se essa propriedade for exclusiva e persistente, o driver poderá definir WPD_OBJECT_PERSISTENT_UNIQUE_ID e WPD_OBJECT_ID com o mesmo valor.
WPD_OBJECT_IS_DRM_PROTECTED VT_BOOL Um valor booliano que especifica se os dados de mídia são protegidos por DRM. Se não estiver presente, supõe-se que seja False.
WPD_OBJECT_ISHIDDEN VT_BOOL Um valor booliano que especifica se o objeto deve ser oculto. Se não estiver presente, supõe-se que o objeto não esteja oculto.
WPD_OBJECT_CAN_DELETE VT_BOOL Um valor booliano que especifica se o objeto pode ser excluído.
WPD_OBJECT_ISSYSTEM VT_BOOL Um valor booliano que especifica se o objeto representa dados do sistema (como um arquivo do sistema). Se não estiver presente, supõe-se que o objeto não seja um objeto do sistema.
WPD_OBJECT_KEYWORDS VT_LPWSTR Cadeia de caracteres que contém uma lista de palavras-chave delimitadas por espaço associadas a esse objeto.
WPD_OBJECT_LANGUAGE_LOCALE VT_LPWSTR Uma cadeia de caracteres que dentifica a linguagem usada por um determinado objeto. Se vários idiomas estiverem contidos nesse objeto, ele deverá identificar o idioma principal. Essa propriedade pode conter um código de idioma, conforme definido em ISO-639, como: "en". Ele também pode conter um código de país-idioma, que consiste em um código de idioma de dois ou três caracteres, conforme definido no padrão ISO-639, seguido por um hífen e, em seguida, seguido por um código de país, conforme definido em ISO-3166, como: "en-US".
WPD_OBJECT_NAME VT_LPWSTR O nome de exibição do objeto.
WPD_OBJECT_NON_CONSUMABLE VT_BOOL Um valor booliano que especifica se esse objeto deve ser compreendido ou simplesmente armazenado pelo dispositivo. Se essa propriedade não estiver presente, todos os dados serão considerados destinados ao consumo.
WPD_OBJECT_ORIGINAL_FILE_NAME VT_LPWSTR Um nome de cadeia de caracteres para o arquivo.
WPD_OBJECT_PARENT_ID VT_LPWSTR A ID do objeto pai. O único objeto que pode retornar uma cadeia de caracteres vazia para esse valor é o objeto do dispositivo raiz. Para modificar essa propriedade, chame IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE).
WPD_OBJECT_PERSISTENT_UNIQUE_ID VT_LPWSTR Uma ID de cadeia de caracteres que identifica exclusivamente o objeto no dispositivo, semelhante a WPD_OBJECT_ID, mas deve ser armazenada entre sessões. Se o identificador de objeto WPD_OBJECT_ID for exclusivo e persistente, o driver poderá definir WPD_OBJECT_PERSISTENT_UNIQUE_ID e WPD_OBJECT_ID com o mesmo valor.
WPD_OBJECT_REFERENCES VT_UNKNOWN Um IPortableDevicePropVariantCollection que contém uma coleção de IDs de objeto VT_LPWSTR identificando os objetos referenciados. Isso só será necessário se o objeto for um objeto de referência, como uma pasta ou playlist.
WPD_OBJECT_SIZE VT_UI8 O tamanho dos dados do recurso de objeto.
WPD_OBJECT_SYNC_ID VT_LPWSTR Uma cadeia de caracteres opaca criada por um cliente para reter o estado entre sessões sem reter um catálogo de conteúdo do dispositivo conectado.

Requisitos

Requisito Valor
parâmetro
PortableDevice.h

Confira também

Propriedades e atributos do WPD