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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. 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.
Syntax
HRESULT SetNamedValue(
[in] LPCWSTR pszName,
[in] const PROPVARIANT *pv
);
Parameter
[in] pszName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen der Eigenschaft enthält.
[in] pv
Ein Zeiger auf den Wert, auf den die Eigenschaft festgelegt ist.
Rückgabewert
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.
Hinweise
Die folgenden Variantentypen werden für Eigenschaftswerte unterstützt. Die folgende Tabelle zeigt die Wertetypen, die das Framework für bestimmte Variantentypen schreibt.
| Varianttyp | 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |