IPortableDeviceValues::GetValue-Methode
Die GetValue-Methode ruft einen PROPVARIANT-Wert ab, der durch einen Schlüssel angegeben wird.
Syntax
HRESULT GetValue(
[in] REFPROPERTYKEY key,
[out] PROPVARIANT *pValue
);
Parameter
-
Key [ In]
-
Ein REFPROPERTYKEY-Schlüssel, der das abzurufende Element angibt.
-
pValue [ out]
-
Zeiger auf den abgerufenen PROPVARIANT-Wert. Der Aufrufer muss den Arbeitsspeicher durch Aufrufen von PropVariantClear frei geben, wenn er damit fertig ist.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Die durch key angegebene Eigenschaft ist nicht in der Auflistung. |
Hinweise
Wenn VARTYPE für pValue VT VECTOR oder VT UI1 ist, wird das Abrufen eines Nullpuffers oder eines Puffers der _ Größe _ 0 (null) nicht unterstützt. Beispielsweise sind weder pValue.caub.pElems = NULL noch pValue.caub.cElems = 0 zulässig.
Diese Methode kann verwendet werden, um einen Wert eines beliebigen Typs aus der Auflistung abzurufen. Wenn Sie den Werttyp jedoch im Voraus kennen, verwenden Sie eine der speziellen Abrufmethoden dieser Schnittstelle, um den Mehraufwand der direkten Arbeit mit PROPVARIANT-Werten zu vermeiden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|