Metodo IPortableDeviceCapabilities::GetSupportedFormatProperties (portabledeviceapi.h)
Il metodo GetSupportedFormatProperties recupera le proprietà supportate dagli oggetti di un formato specificato nel dispositivo.
Sintassi
HRESULT GetSupportedFormatProperties(
[in] REFGUID Format,
[out] IPortableDeviceKeyCollection **ppKeys
);
Parametri
[in] Format
REFGUID che specifica il formato dell'oggetto. Per un elenco dei formati definiti dai dispositivi portatili Windows, vedere Formati di oggetti.
[out] ppKeys
Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDeviceKeyCollection che contiene le proprietà supportate per il formato specificato. Per un elenco delle proprietà definite dai dispositivi portatili Windows, vedere Proprietà e attributi. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
Commenti
È possibile specificare WPD_OBJECT_FORMAT_ALL per il parametro Format per recuperare il set completo di attributi di proprietà.
Se un oggetto non dispone di un valore assegnato a una proprietà specifica o se la proprietà è stata eliminata, un dispositivo potrebbe non segnalare affatto la proprietà durante l'enumerazione delle relative proprietà. Un altro dispositivo potrebbe segnalare la proprietà, ma con una stringa vuota o un valore pari a zero. Per evitare questa incoerenza, è possibile chiamare questo metodo per apprendere tutte le proprietà che è possibile impostare su un oggetto specifico.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | portabledeviceapi.h |
| Libreria | PortableDeviceGUIDs.lib |