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

  • Artikel

[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
E_INVALIDARG
 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

Weitere Informationen

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore