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 |
|---|---|
|
Il metodo è riuscito. |
|
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 |
|
| Libreria |
|