MÉTHODE IMDSPDevice3 ::GetProperty (mswmdm.h)

Article
02/29/2024

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

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

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.