PSPropertyBag_ReadType-Funktion (propsys.h)
Liest den Typ des Datenwerts einer Eigenschaft, die in einem Eigenschaftenbehälter gespeichert ist.
Syntax
PSSTDAPI PSPropertyBag_ReadType(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] VARIANT *var,
[out] VARTYPE type
);
Parameter
[in] propBag
Typ: IPropertyBag*
Ein Zeiger auf ein IPropertyBag-Objekt , das den Eigenschaftenbehälter darstellt, in dem die Eigenschaft gespeichert ist.
[in] propName
Typ: LPCWSTR
Ein Zeiger auf eine NULL-endende Eigenschaftsnamenszeichenfolge.
[out] var
Typ: VARIANT*
Gibt bei erfolgreicher Funktionsvollständigung einen Zeiger auf einen VARIANT-Datentyp zurück, der den Eigenschaftswert enthält.
[out] type
Typ: VARTYPE*
Wenn type VT_EMPTY ist, liest diese Funktion den VARIANT-Wert der Eigenschaft im propBag-Parameter IPropertyBag. Wenn type nicht VT_EMPTY und nicht mit variant read identisch ist, versucht diese Funktion, den VARIANT-Lesevorgang vor der Rückgabe in den vartype-Wert zu konvertieren, der durch den Type-Parameter definiert ist.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
IPropertyBag und IPersistPropertyBag optimieren die Funktionalität zum Speichern als Text. IPropertyBag und IPropertyBag2 stellen ein Objekt mit einem Eigenschaftenbehälter bereit, in dem das Objekt seine Eigenschaften dauerhaft speichern kann. IPropertyBag2 ermöglicht dem Objekt das Abrufen von Typinformationen für jede Eigenschaft: IPropertyBag2::Read bewirkt, dass eine oder mehrere Eigenschaften aus dem Eigenschaftenbehälter gelesen werden, und IPropertyBag2::Write bewirkt, dass eine oder mehrere Eigenschaften im Eigenschaftenbehälter gespeichert werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propsys.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |