IWDFNamedPropertyStore2 ::D eleteNamedValue, méthode (wudfddi.h)

Article
02/07/2025

[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer 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 null-terminated qui contient un nom de valeur de Registre.

Valeur de retour

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

Retourner le code	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 fonction de rappel 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;
    }    
}

Exigences

Exigence	Valeur
fin du support	Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible	Bureau
version minimale de UMDF	1.9
d’en-tête	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory ::RetrieveDevicePropertyStore

Partager via