Condividi tramite


Proprietà degli oggetti

I dispositivi portatili Windows supportano le proprietà dell'oggetto seguenti.

Proprietà VarType Descrizione
WPD_OBJECT_BACK_REFERENCES VT_UNKNOWN Oggetto IPortableDevicePropVariantCollection di tipo VT_LPWSTR che indica un elenco di ObjectID. Quando un oggetto viene fatto riferimento a un oggetto contenitore, ad esempio un oggetto audio a cui fa riferimento una playlist, l'oggetto a cui viene fatto riferimento usa questa proprietà per fare riferimento al relativo oggetto contenitore. L'oggetto audio può fare riferimento all'oggetto playlist in questo esempio.
WPD_OBJECT_CAN_DELETE VT_BOOL Valore booleano che specifica se l'oggetto specificato può essere eliminato.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID VT_LPWSTR ID oggetto dell'oggetto funzionale più vicino che contiene questo oggetto. Ad esempio, un file all'interno di un oggetto funzionale di archiviazione avrà questa proprietà impostata sull'ID dell'oggetto funzionale di archiviazione.
WPD_OBJECT_CONTENT_TYPE VT_CLSID GUID che identifica il tipo generico di questo oggetto, ad esempio un documento o un messaggio di posta elettronica. Questo può essere un tipo di oggetto definito da Dispositivi portatili Windows o un tipo di contenuto del driver personalizzato. L'oggetto device è l'unico oggetto che non segnala questa proprietà.
WPD_OBJECT_DATE_AUTHORED VT_DATE Valore che specifica la data e l'ora di creazione del contenuto. Potrebbe non essere uguale alla data di creazione del file. Ad esempio, un file musicale ha una data di creazione di quando è stata registrata la musica, ma una data di creazione di quando il file WMA è stato effettivamente creato nel dispositivo.
WPD_OBJECT_DATE_CREATED VT_DATE Valore che specifica la data e l'ora di creazione dell'oggetto nel dispositivo.
WPD_OBJECT_DATE_MODIFIED VT_DATE Valore che specifica la data e l'ora in cui l'oggetto è stato modificato nel dispositivo.
WPD_OBJECT_FORMAT VT_CLSID GUID che identifica il formato dei dati dell'oggetto. Questo può essere un formato definito dai dispositivi portatili Windows o da un formato di driver personalizzato.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE VT_BOOL Valore booleano che specifica se l'immagine di anteprima per questo oggetto deve essere creata dai dati delle risorse predefiniti. Questo consente agli oggetti senza una risorsa di anteprima di fornire un'esperienza di esplorazione più amica. L'uso di questo flag può influire sulla prima risposta di visualizzazione, poiché l'applicazione deve recuperare e calcolare un'immagine di anteprima dal dispositivo; è più efficiente fornire una risorsa di immagine di anteprima separata, se possibile.
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME VT_LPWSTR Se l'oggetto specificato viene visualizzato come percorso hint, questa proprietà indica il nome specifico dell'hint da visualizzare anziché il nome dell'oggetto. I driver possono specificare hint di posizione per vari tipi di contenuto. Questi possono essere considerati collegamenti a oggetti cartelle di primo livello che contengono oggetti dei tipi specificati. I client che usano questi hint di posizione possono visualizzare un nome per questi collegamenti che differiscono dal nome dell'oggetto della cartella. Se questa proprietà non esiste, in genere viene utilizzata la WPD_OBJECT_NAME .
WPD_OBJECT_ID VT_LPWSTR ID stringa che identifica in modo univoco l'oggetto nel dispositivo. Questo ID non deve essere archiviato tra le sessioni. Se questa proprietà è sia univoca che persistente, il driver può impostare sia WPD_OBJECT_PERSISTENT_UNIQUE_ID che WPD_OBJECT_ID sullo stesso valore.
WPD_OBJECT_IS_DRM_PROTECTED VT_BOOL Valore booleano che specifica se i dati multimediali sono protetti da DRM. Se non presente, si presuppone che sia False.
WPD_OBJECT_ISHIDDEN VT_BOOL Valore booleano che specifica se l'oggetto deve essere nascosto. Se non presente, si presuppone che l'oggetto non sia nascosto.
WPD_OBJECT_CAN_DELETE VT_BOOL Valore booleano che specifica se l'oggetto può essere eliminato.
WPD_OBJECT_ISSYSTEM VT_BOOL Valore booleano che specifica se l'oggetto rappresenta i dati di sistema, ad esempio un file di sistema. Se non presente, si presuppone che l'oggetto non sia un oggetto di sistema.
WPD_OBJECT_KEYWORDS VT_LPWSTR Stringa contenente un elenco di parole chiave delimitate da spazio associate a questo oggetto.
WPD_OBJECT_LANGUAGE_LOCALE VT_LPWSTR Stringa che rientri la lingua utilizzata da un oggetto specificato. Se più lingue sono contenute in questo oggetto, deve identificare il linguaggio primario. Questa proprietà può contenere un codice del linguaggio, come definito in ISO-639, ad esempio: "en". Può anche contenere un codice paese del linguaggio, costituito da un codice linguistico di due o tre caratteri come definito nello standard ISO-639, seguito da un trattino, seguito da un codice paese come definito in ISO-3166, ad esempio: "en-US".
WPD_OBJECT_NAME VT_LPWSTR Nome visualizzato per l'oggetto.
WPD_OBJECT_NON_CONSUMABLE VT_BOOL Valore booleano che specifica se questo oggetto deve essere compreso o archiviato semplicemente dal dispositivo. Se questa proprietà non è presente, si presuppone che tutti i dati siano destinati all'utilizzo.
WPD_OBJECT_ORIGINAL_FILE_NAME VT_LPWSTR Nome stringa per il file.
WPD_OBJECT_PARENT_ID VT_LPWSTR ID oggetto dell'oggetto padre. L'unico oggetto che può restituire una stringa vuota per questo valore è l'oggetto del dispositivo radice. Per modificare questa proprietà, chiamare IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE).
WPD_OBJECT_PERSISTENT_UNIQUE_ID VT_LPWSTR ID stringa che identifica in modo univoco l'oggetto nel dispositivo, simile a WPD_OBJECT_ID, ma deve essere archiviato tra sessioni. Se l'identificatore di oggetto WPD_OBJECT_ID è sia univoco che persistente, il driver può impostare sia WPD_OBJECT_PERSISTENT_UNIQUE_ID che WPD_OBJECT_ID sullo stesso valore.
WPD_OBJECT_REFERENCES VT_UNKNOWN IPortableDevicePropVariantCollection contenente una raccolta di ID oggetto VT_LPWSTR che identificano gli oggetti a cui si fa riferimento. Questa operazione è necessaria solo se l'oggetto è un oggetto di riferimento, ad esempio una cartella o una playlist.
WPD_OBJECT_SIZE VT_UI8 Dimensioni dei dati della risorsa oggetto.
WPD_OBJECT_SYNC_ID VT_LPWSTR Stringa opaca creata da un client per mantenere lo stato tra le sessioni senza conservare un catalogo di contenuto del dispositivo connesso.

Requisiti

Requisito Valore
Intestazione
PortableDevice.h

Vedi anche

Proprietà e attributi WPD