Metodo IPortableDeviceProperties::GetValues (portabledeviceapi.h)

Articolo
08/25/2023

Il metodo GetValues recupera un elenco di proprietà specificate da un oggetto specificato in un dispositivo.

Sintassi

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Parametri

[in] pszObjectID

Puntatore a una stringa con terminazione Null contenente l'ID dell'oggetto su cui eseguire la query. Per specificare il dispositivo, usare WPD_DEVICE_OBJECT_ID.

[in] pKeys

Puntatore a un'interfaccia IPortableDeviceKeyCollection che contiene una o più proprietà per cui eseguire una query. Se è NULL, tutte le proprietà verranno recuperate. Per un elenco delle proprietà definite dai dispositivi portatili Windows, vedere Proprietà e attributi .

[out] ppValues

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDeviceValues che contiene i valori delle proprietà richieste. Questi valori verranno restituiti come coppie PROPERTYKEY/valore, in cui il tipo di dati del valore dipende dalla proprietà . Se non è stato possibile recuperare un valore per qualche motivo, il tipo restituito verrà VT_ERROR e conterrà un valore HRESULT che descrive l'errore di recupero. 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
S_OK	Tutti i valori delle proprietà richieste sono stati recuperati.
S_FALSE	Impossibile recuperare uno o più valori di proprietà. Le proprietà del problema avranno un valore HRESULT nel parametro ppValues recuperato.