Metodo IWDFNamedPropertyStore2::D eleteNamedValue (wudfddi.h)

  • Articolo

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

Codice restituito Descrizione
E_INVALIDARG
 Il chiamante ha fornito un argomento di input non valido.
 

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

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1,9
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore