Méthode IWDFNamedPropertyStore ::GetNamedValue (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 GetNamedValue récupère la valeur d’une propriété.
Syntaxe
HRESULT GetNamedValue(
[in] LPCWSTR pszName,
[out] PROPVARIANT *pv
);
Paramètres
[in] pszName
Pointeur vers une chaîne terminée par null qui contient le nom de la propriété.
[out] pv
Pointeur vers une variable qui reçoit la valeur de la propriété .
Valeur retournée
GetNamedValue 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
La méthode GetNamedValue alloue de la mémoire pour une chaîne dans la structure PROPVARIANT pointée vers le paramètre pv . L’appelant doit ensuite libérer cette mémoire en appelant la fonction PropVariantClear , comme indiqué dans l’extrait de code suivant :
hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);
Si l’appelant ne libère pas la mémoire, une fuite de mémoire peut se produire.
Les types de variantes suivants sont pris en charge pour les valeurs de propriété. Le tableau suivant montre le type de variante retourné quel que soit le type de variante d’origine.
Type de variante | Type variant récupéré |
---|---|
VT_BSTR | Lorsque les clients lisent une valeur de chaîne, la valeur est retournée en tant que VT_LPWSTR quel que soit le type de variante d’origine utilisé pour écrire la valeur. |
VT_LPWSTR | |
VT_LPSTR | |
VT_I1 | Lorsque les clients lisent une valeur entière, la valeur est retournée en tant que VT_UI4 quel que soit le type de variante d’origine utilisé pour écrire la valeur. |
VT_UI1 | |
VT_I2 | |
VT_UI2 | |
VT_I4 | |
VT_UI4 | |
VT_UINT | |
VT_BLOB | La valeur binaire est retournée en tant que VT_BLOB. |
VT_VECTOR | VT_LPWSTR | Le tableau de chaînes est retourné en tant que VT_VECTOR | VT_LPWSTR |
Une chaîne qui contient des variables d’environnement est développée en lecture.
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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour