PSPropertyBag_ReadBSTR-Funktion (propsys.h)
Liest einen BSTR-Datenwert aus einer Eigenschaft in einem Eigenschaftenbehälter.
Syntax
PSSTDAPI PSPropertyBag_ReadBSTR(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] BSTR *value
);
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 NULL-endende Eigenschaftsnamenzeichenfolge.
[out] value
Typ: BSTR*
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf einen BSTR-Eigenschaftswert .
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die Eigenschaftenbehälterfunktions-API konvertiert zwischen Fenstertypen und dem VARIANT-Typ , der zum Ausdrücken von Werten in einem Eigenschaftenbehälter verwendet wird. Dadurch wird die Verwendung von Eigenschaftenbehältern vereinfacht, Anwendungen vereinfacht und häufige Codierungsfehler vermieden.
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) |