Méthode IWDFNamedPropertyStore ::SetNamedValue (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 SetNamedValue définit la valeur d’une propriété.
Syntaxe
HRESULT SetNamedValue(
[in] LPCWSTR pszName,
[in] const PROPVARIANT *pv
);
Paramètres
[in] pszName
Pointeur vers une chaîne terminée par null qui contient le nom de la propriété .
[in] pv
Pointeur vers la valeur sur laquelle la propriété est définie.
Valeur retournée
SetNamedValue retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
Les types de variantes suivants sont pris en charge pour les valeurs de propriété. Le tableau suivant montre les types de valeurs que l’infrastructure écrit pour des types de variantes particuliers.
| Type de variante | Write |
|---|---|
| VT_BSTR | Écrit une valeur de chaîne. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Écrit une valeur entière. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | Écrit une valeur binaire. |
| VT_VECTOR | VT_LPWSTR | Écrit un tableau de chaînes. |
Pour plus d’informations, consultez Utilisation du Registre dans les pilotes basés sur UMDF.
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.5 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
| DLL | WUDFx.dll |