IWDFNamedPropertyStore::GetNamedValue-Methode (wudfddi.h)

Artikel
03/01/2024

[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 in neueren 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 GetNamedValue-Methode ruft den Wert einer Eigenschaft ab.

Syntax

HRESULT GetNamedValue(
  [in]  LPCWSTR     pszName,
  [out] PROPVARIANT *pv
);

Parameter

[in] pszName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der Eigenschaft enthält.

[out] pv

Ein Zeiger auf eine Variable, die den Wert für die -Eigenschaft empfängt.

Rückgabewert

GetNamedValue 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 GetNamedValue-Methode ordnet Arbeitsspeicher für eine Zeichenfolge in der PROPVARIANT-Struktur zu, auf die der pv-Parameter verweist. Der Aufrufer muss diesen Arbeitsspeicher dann freigeben, indem er die PropVariantClear-Funktion aufruft, wie im folgenden Codeausschnitt gezeigt:

hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);

Wenn der Aufrufer den Arbeitsspeicher nicht freigibt, kann es zu einem Speicherverlust kommen.

Die folgenden Variantentypen werden für Eigenschaftswerte unterstützt. Die folgende Tabelle zeigt den Variant-Typ, der unabhängig vom ursprünglichen Variantentyp zurückgegeben wird.

Varianttyp	Abgerufener Variant-Typ
VT_BSTR	Während Clients einen Zeichenfolgenwert lesen, wird der Wert unabhängig vom ursprünglichen Variantentyp, der zum Schreiben des Werts verwendet wurde, als VT_LPWSTR zurückgegeben.
VT_LPWSTR
VT_LPSTR
VT_I1	Während Clients einen ganzzahligen Wert lesen, wird der Wert als VT_UI4 unabhängig vom ursprünglichen Variantentyp zurückgegeben, der zum Schreiben des Werts verwendet wurde.
VT_UI1
VT_I2
VT_UI2
VT_I4
VT_UI4
VT_UINT
VT_BLOB	Der binärwert wird als VT_BLOB zurückgegeben.
VT_VECTOR \| VT_LPWSTR	Das Zeichenfolgenarray wird als VT_VECTOR \| VT_LPWSTR

Eine Zeichenfolge, die Umgebungsvariablen enthält, wird beim Lesen erweitert.

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

PROPVARIANT

PropVariantClear

Freigeben über