MÉTHODE IMDSPDevice3 ::GetProperty (mswmdm.h)
La méthode GetProperty récupère une propriété d’appareil spécifique.
Syntaxe
HRESULT GetProperty(
[in] LPCWSTR pwszPropName,
[out] PROPVARIANT *pValue
);
Paramètres
[in] pwszPropName
Nom de la propriété récupérée à partir de l’appareil.
[out] pValue
Valeur retournée pour la propriété .
Valeur retournée
Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Remarques
La variante vers laquelle pValue pointe est définie sur un PROPVARIANT vide, c’est-à-dire que son VT est défini sur VT_EMPTY.
Le fournisseur de services doit définir cette variante sur la valeur de propriété appropriée pour la propriété pwszPropName.
Si pwszPropName est g_wszWMDMSupportedDeviceProperties, le fournisseur de services doit retourner un tableau des propriétés de l’appareil prises en charge. Dans ce cas, le VT de la variante doit être VT_BSTR | VT_ARRAY.
Pour obtenir la liste des noms de propriétés d’appareil standard, consultez Constantes de métadonnées.
Cette méthode est similaire aux méthodes IMDSPStorage3 ::GetMetadata et IMDSPStorage4 ::GetSpecifiedMetadata pour les stockages, mais cette méthode ne peut obtenir qu’une seule propriété à la fois.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |