Partager via


Méthode ISensor ::SetProperties (sensorsapi.h)

Important

Utilisez plutôt l’API de capteur UWP .

L’API de capteur COM est déconseillée et ne doit pas être utilisée dans les nouvelles applications. Aucune fonctionnalité ou amélioration supplémentaire n’est planifiée et la prise en charge sera limitée.

Spécifie les propriétés du capteur.

Syntaxe

HRESULT SetProperties(
  [in]  IPortableDeviceValues *pProperties,
  [out] IPortableDeviceValues **ppResults
);

Paramètres

[in] pProperties

Pointeur vers une interface IPortableDeviceValues contenant la liste des propriétés et des valeurs à définir.

[out] ppResults

Adresse d’une interface IPortableDeviceValues qui reçoit la liste des propriétés qui ont été correctement définies. Chaque propriété a une valeur HRESULT associée, qui indique si la définition de la propriété a réussi.

Valeur retournée

La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Code de retour Descriptif
S_OK
La méthode a réussi.
S_FALSE
Échec de la demande de définition d’une ou plusieurs des propriétés spécifiées. Inspectez ppResults pour déterminer quelles propriétés, le cas échéant, ont réussi.
E_POINTER
NULL a été transmis pour ppResults.

Remarques

Cette méthode vous permet de spécifier les valeurs d’une ou plusieurs propriétés, telles que la fabrication, le modèle et le numéro de série du capteur, en effectuant un seul appel.

Toutes les propriétés ne peuvent pas être définies.

IPortableDeviceValues est défini par l’API Appareils portables Windows.

Examples

Pour obtenir un exemple de définition des propriétés, consultez Définition et récupération des propriétés du capteur.

Spécifications

Requirement Valeur
Client minimum requis Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Fenêtres
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

Voir aussi

GetProperties

ISensor