PSPropertyBag_ReadLONG-Funktion (propsys.h)

Liest einen LONG-Datenwert aus einer Eigenschaft in einem Eigenschaftenbehälter.

Syntax

PSSTDAPI PSPropertyBag_ReadLONG(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LONG         *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 Zeichenfolge, die mit NULL beendet wurde.

[out] value

Typ: LONG*

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf einen LONG-Eigenschaftswert .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der Eigenschaftenbehälter die angegebene Eigenschaft noch nicht enthält, ist der Aufruf weiterhin erfolgreich.

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

Weitere Informationen

PSPropertyBag_WriteLONG