PSPropertyBag_WritePropertyKey-Funktion (propsys.h)
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) |