Méthode IWDFNamedPropertyStore2 ::D eleteNamedValue (wudfddi.h)
[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 |
---|---|
|
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 |