IWDFNamedPropertyStore::SetNamedValue-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die SetNamedValue--Methode legt den Wert einer Eigenschaft fest.
HRESULT SetNamedValue(
[in] LPCWSTR pszName,
[in] const PROPVARIANT *pv
);
[in] pszName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen der Eigenschaft enthält.
[in] pv
Ein Zeiger auf den Wert, auf den die Eigenschaft festgelegt ist.
SetNamedValue gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Die folgenden Variantentypen werden für Eigenschaftswerte unterstützt. In der folgenden Tabelle sind die Wertetypen aufgeführt, die vom Framework für bestimmte Variantentypen geschrieben werden.
| Variant-Typ | Schreiben |
|---|---|
| VT_BSTR | Schreibt einen Zeichenfolgenwert. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Schreibt einen ganzzahligen Wert. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | Schreibt einen Binärwert. |
| VT_VECTOR | VT_LPWSTR | Schreibt ein Zeichenfolgenarray. |
Weitere Informationen finden Sie unter Verwenden der Registrierung in UMDF-basierten Treibern.
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |