Metodo IPortableDeviceValues::GetValue

Il metodo GetValue recupera un valore PROPVARIANT specificato da una chiave.

Sintassi

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

Parametri

chiave [in]

Chiave REFPROPERTYKEY che specifica l'elemento da recuperare.

pValue [out]

Puntatore al valore PROPVARIANT recuperato. Il chiamante deve rilasciare la memoria chiamando PropVariantClear al termine dell'operazione.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati 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

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.

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 evitare il sovraccarico dell'uso diretto dei valori PROPVARIANT.

Requisiti

Requisito	Valore
Intestazione	PortableDeviceTypes.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceValues

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue