Metodo IWDFNamedPropertyStore2::D eleteNamedValue (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo DeleteNamedValue elimina un nome valore dal Registro di sistema.

Sintassi

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

Parametri

[in] pwszName

Puntatore a una stringa con terminazione null contenente un nome del valore del Registro di sistema.

Valore restituito

DeleteNamedValue restituisce S_OK se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire il valore seguente:

Questo metodo potrebbe restituire uno degli altri valori che Winerror.h contiene.

Commenti

Prima che un driver chiami DeleteNamedValue, deve chiamare IWDFPropertyStoreFactory::RetrieveDevicePropertyStore per ottenere l'interfaccia IWDFNamedPropertyStore2 .

Per altre informazioni sull'accesso al Registro di sistema, vedere Uso del Registro di sistema nei driver basati su UMDF.

Esempio

L'esempio di codice seguente è una funzione di callback IObjectCleanup::OnCleanup per un oggetto dispositivo. Se il driver ha aggiunto in precedenza un valore alla chiave DEVICEMAP del Registro di sistema, la funzione di callback elimina il valore.

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;
    }    
}

Requisiti

Vedi anche

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore