Metodo IPortableDeviceValues::GetValue (portabledevicetypes.h)

Articolo
08/07/2023

L'interfaccia GetValue recupera un valore PROPVARIANT specificato da una chiave.

Sintassi

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

Parametri

[in] key

Chiave REFPROPERTYKEY che specifica l'elemento da recuperare.

[out] pValue

Puntatore al valore PROPVARIANT recuperato. Il chiamante deve rilasciare la memoria chiamando PropVariantClear al termine della chiamata.

Valore restituito

Il metodo restituisce un HRESULT. I valori restituiti possibili vengono visualizzati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La proprietà specificata dalla chiave non è nella raccolta.

Commenti

Questo metodo può essere usato per recuperare un valore di qualsiasi tipo dalla raccolta. Tuttavia, se si conosce il tipo di valore in anticipo, usare uno dei metodi di recupero specializzati di questa interfaccia per un controllo di tipo aggiuntivo.

Quando varTYPE per pValue è VT_VECTOR o VT_UI1, il recupero di un buffer NULL o di dimensioni zero non è supportato. Ad esempio, né pValue.caub.pElems = NULL né pValue.caub.cElems = 0 sono consentiti.