PSPropertyBag_WritePropertyKey-Funktion (propsys.h)

  • Artikel

Legt den Eigenschaftsschlüsselwert einer Eigenschaft in einem Eigenschaftenbehälter fest.

Syntax

PSSTDAPI PSPropertyBag_WritePropertyKey(
  [in] IPropertyBag   *propBag,
  [in] LPCWSTR        propName,
  [in] REFPROPERTYKEY 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.

[in] value

Typ: REFPROPERTYKEY

Eine PROPERTYKEY-Struktur , die den Eigenschaftsschlüsselwert angibt, der in der Eigenschaft gespeichert werden soll.

Rückgabewert

Typ: HRESULT

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

Hinweise

Eigenschaftenschlüssel identifizieren eine Eigenschaft eindeutig. PKEY_Keywords entspricht beispielsweise System.Keywords. Diese Funktion ist nur für Eigenschaften erfolgreich, die als Teil des Eigenschaftenschemas registriert sind.

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)

Weitere Informationen

PSPropertyBag_ReadPropertyKey