PSPropertyBag_ReadStrAlloc-Funktion (propsys.h)

Liest einen Zeichenfolgendatenwert aus einer Eigenschaft in einem Eigenschaftenbehälter und ordnet arbeitsspeicher für die gelesene Zeichenfolge zu.

Syntax

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *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

Ein Zeiger auf eine NULL-endende Eigenschaftsnamenzeichenfolge.

[out] value

Typ: PWSTR*

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf einen Zeichenfolgendatenwert aus einer Eigenschaft in einem Eigenschaftenbehälter und ordnet Arbeitsspeicher für die gelesene Zeichenfolge zu. Der Aufrufer der PSPropertyBag_ReadStrAlloc-Funktion muss eine CoTaskMemFree-Funktion für diesen Parameter aufrufen.

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)