PSPropertyBag_ReadStr-Funktion (propsys.h)
Liest den Zeichenfolgendatenwert einer Eigenschaft in einem Eigenschaftenbehälter.
Syntax
PSSTDAPI PSPropertyBag_ReadStr(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] LPWSTR value,
[out] int characterCount
);
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
Eine Zeichenfolge, die mit NULL beendet wurde.
[out] value
Typ: LPCWSTR
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf einen Zeichenfolgeneigenschaftswert.
[out] characterCount
Typ: int
Diese Funktion gibt die ganze Zahl zurück, die die Größe (maximale Anzahl von Zeichen) des zurückgegebenen value-Parameters darstellt.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die Eigenschaftenbehälter-Funktions-API konvertiert zwischen Fenstertypen und dem VARIANT-Typ , der zum Ausdrücken von Werten in einem Eigenschaftenbehälter verwendet wird. Dies erleichtert die Verwendung von Eigenschaftenbehältern, vereinfacht Anwendungen und vermeidet häufige Codierungsfehler.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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) |