IWDFNamedPropertyStore2::D eleteNamedValue-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 DeleteNamedValue-Methode löscht einen Wertnamen aus der Registrierung.
Syntax
HRESULT DeleteNamedValue(
[in] LPCWSTR pwszName
);
Parameter
[in] pwszName
Ein Zeiger auf eine NULL-Zeichenfolge, die einen Registrierungswertnamen enthält.
Rückgabewert
DeleteNamedValue gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise den folgenden Wert zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Aufrufer hat ein ungültiges Eingabeargument angegeben. |
Diese Methode gibt möglicherweise einen der anderen Werte zurück, die Winerror.h enthält.
Hinweise
Bevor ein Treiber DeleteNamedValue aufruft, muss er IWDFPropertyStoreFactory::RetrieveDevicePropertyStore aufrufen, um die IWDFNamedPropertyStore2-Schnittstelle abzurufen.
Weitere Informationen zum Zugriff auf die Registrierung finden Sie unter Verwenden der Registrierung in UMDF-basierten Treibern.
Beispiele
Das folgende Codebeispiel ist eine IObjectCleanup::OnCleanup-Rückruffunktion für ein Geräteobjekt. Wenn der Treiber dem DEVICEMAP-Schlüssel der Registrierung zuvor einen Wert hinzugefügt hatte, löscht die Rückruffunktion den Wert.
VOID
CMyDevice::OnCleanup(
IWDFObject* pWdfObject
)
{
UNREFERENCED_PARAMETER(pWdfObject);
if ((m_CreatedLegacyHardwareKey == TRUE) &&
(m_LegacyHardwarePropertyStore != NULL))
{
m_LegacyHardwarePropertyStore->DeleteNamedValue(m_PdoName);
SAFE_RELEASE(m_LegacyHardwarePropertyStore);
delete[] m_PdoName;
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.9 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |