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

Weitere Informationen

Ipropertystore

IPropertyStore::GetAt