WdfRegistryRemoveValue-Funktion (wdfregistry.h)
[Gilt für KMDF und UMDF]
Die WdfRegistryRemoveValue-Methode entfernt einen angegebenen Wert und seine Daten aus einem angegebenen Registrierungsschlüssel.
Syntax
NTSTATUS WdfRegistryRemoveValue(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName
);
Parameter
[in] Key
Ein Handle für ein Registrierungsschlüsselobjekt, das einen geöffneten Registrierungsschlüssel darstellt.
[in] ValueName
Ein Zeiger auf eine UNICODE_STRING-Struktur , die einen Wertnamen enthält.
Rückgabewert
WdfRegistryRemoveValue gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise einen der folgenden Werte zurück:
Rückgabecode | Beschreibung |
---|---|
|
WdfRegistryRemoveValue wurde nicht unter IRQL = PASSIVE_LEVEL aufgerufen. |
|
Ein ungültiger Parameter wurde angegeben. |
|
Der Treiber hat den Registrierungsschlüssel nicht mit KEY_SET_VALUE Zugriff geöffnet. |
Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zu Registrierungsschlüsselobjekten finden Sie unter Verwenden der Registrierung in Framework-Based-Treibern.
Beispiele
Im folgenden Codebeispiel werden der MyValue-Wert und die zugehörigen Daten aus einem angegebenen Registrierungsschlüssel entfernt.
DECLARE_CONST_UNICODE_STRING(valueName, L"MyValue");
status = WdfRegistryRemoveValue(
Key,
&valueName
);
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
UMDF-Mindestversion | 2.0 |
Kopfzeile | wdfregistry.h (einschließen von Wdf.h) |
Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | PASSIVE_LEVEL |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |