IWDFNamedPropertyStore ::SetNamedValue, méthode (wudfddi.h)
[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 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 de retour
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 variant particuliers.
| Type de variante | Écrire |
|---|---|
| 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.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |