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

Weitere Informationen

IWDFNamedPropertyStore