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

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mithilfe von 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 Začínáme 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-beendete 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 bereitgestellt.
 

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

Bemerkungen

Bevor ein Treiber DeleteNamedValue aufruft, muss er IWDFPropertyStoreFactory::RetrieveDevicePropertyStore aufrufen, um die IWDFNamedPropertyStore2-Schnittstelle abzurufen.

Weitere Informationen zum Zugreifen 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 zuvor einen Wert zum DEVICEMAP-Schlüssel der Registrierung 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

   
Ende des Supports Nicht verfügbar in UMDF 2.0 und höher.
Zielplattform Desktop
UMDF-Mindestversion 1.9
Header wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Siehe auch

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore