IPropertyStore::GetValue-Methode (propsys.h)
Diese Methode ruft die Daten für eine bestimmte Eigenschaft ab.
Syntax
HRESULT GetValue(
REFPROPERTYKEY key,
PROPVARIANT *pv
);
Parameter
key
TBD
pv
Nachdem die IPropertyStore::GetValue Methode erfolgreich zurückgegeben wurde, verweist dieser Parameter auf eine PROPVARIANT-Struktur , die Daten zur -Eigenschaft enthält.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK oder INPLACE_S_TRUNCATED oder andernfalls einen Fehlerwert zurück.
INPLACE_S_TRUNCATED wird zurückgegeben, um anzugeben, dass der zurückgegebene PROPVARIANT in eine kanonischere Form konvertiert wurde. Dies geschieht beispielsweise, um führende oder nachgestellte Leerzeichen aus einem Zeichenfolgenwert zu kürzen. Sie müssen das Makro SUCCEEDED verwenden, um den Rückgabewert zu überprüfen, der INPLACE_S_TRUNCATED als Erfolgreichcode behandelt. Das MAKRO SUCCEEDED ist in der Datei Winerror.h definiert.
Hinweise
Wenn der PROPERTYKEY, auf den im Schlüssel verwiesen wird, nicht im Eigenschaftenspeicher vorhanden ist, gibt diese Methode S_OK zurück, und das vt-Element der Struktur, auf das von pv verwiesen wird, wird auf VT_EMPTY festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar mit Windows Vista und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Universell |
| Header | propsys.h |
| Bibliothek | Propsys.idl |
| IRQL | Alle Ebenen |