IWMDMDevice3 ::SetProperty, méthode (mswmdm.h)

Article
03/06/2024

La méthode SetProperty définit une propriété d’appareil spécifique, si elle est accessible en écriture.

Syntaxe

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

Paramètres

[in] pwszPropName

Nom de chaîne à caractère large et terminé par null de la propriété à définir. Cette opération remplace toute propriété existante portant le même nom. Une fois que l’application a effectué cet appel, elle doit libérer toute mémoire dynamique à l’aide de PropVariantClear. Une liste de constantes de nom de propriété standard est donnée dans Constantes de métadonnées.

[in] pValue

Valeur de la propriété définie.

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 suivantes de codes d’erreur :

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

Cette méthode définit la propriété d’appareil spécifiée. Pour obtenir la liste des propriétés d’appareil prises en charge, le client doit interroger la méthode IWMDMDevice3 ::GetProperty pour la propriété g_wszWMDMSupportedDeviceProperties .

Pour obtenir la liste des noms de propriétés d’appareil, consultez Constantes de métadonnées.

Cette méthode est similaire à la méthode SetMetadata pour les stockages, mais cette méthode ne peut définir qu’une seule propriété à la fois.

Toutes les propriétés de l’appareil ne peuvent pas être définies.