Méthode IWDFNamedPropertyStore2 ::D eleteNamedValue (wudfddi.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode DeleteNamedValue supprime un nom de valeur du Registre.

Syntaxe

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

Paramètres

[in] pwszName

Pointeur vers une chaîne terminée par null qui contient un nom de valeur de Registre.

Valeur retournée

DeleteNamedValue retourne S_OK si l’opération réussit. Sinon, la méthode peut retourner la valeur suivante :

Code de retour Description
E_INVALIDARG
 L’appelant a fourni un argument d’entrée non valide.
 

Cette méthode peut retourner l’une des autres valeurs que Winerror.h contient.

Remarques

Avant qu’un pilote appelle DeleteNamedValue, il doit appeler IWDFPropertyStoreFactory ::RetrieveDevicePropertyStore pour obtenir l’interface IWDFNamedPropertyStore2 .

Pour plus d’informations sur l’accès au Registre, consultez Utilisation du Registre dans les pilotes basés sur UMDF.

Exemples

L’exemple de code suivant est une fonction de rappel IObjectCleanup ::OnCleanup pour un objet d’appareil. Si le pilote avait précédemment ajouté une valeur à la clé DEVICEMAP du Registre, la fonction de rappel supprime la valeur.

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

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1,9
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory ::RetrieveDevicePropertyStore