IWDFNamedPropertyStore2::D eleteNamedValue-Methode (wudfddi.h)

Artikel
02/07/2025

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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-terminated string that contains a registry value name.

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
E_INVALIDARG	Der Aufrufer hat ein ungültiges Eingabeargument bereitgestellt.

Diese Methode gibt möglicherweise einen der anderen Werte zurück, die Winerror.h enthält.

Bemerkungen

Bevor ein Treiber DeleteNamedValueaufruft, 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 Werthinzugefü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
Mindest-UMDF-Version	1.9
Header-	wudfddi.h (include Wudfddi.h)
DLL-	WUDFx.dll

Siehe auch

IWDFNamedPropertyStore2-

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore

Freigeben über