Freigeben über


ISensor::SetProperties-Methode (sensorsapi.h)

Von Bedeutung

Verwenden Sie stattdessen die UWP-Sensor-API .

Die COM-basierte Sensor-API ist veraltet und sollte nicht in neuen Anwendungen verwendet werden. Es sind keine zusätzlichen Features oder Verbesserungen geplant, und der Support wird eingeschränkt.

Gibt Sensoreigenschaften an.

Syntax

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

Die Parameter

[in] pProperties

Zeiger auf eine IPortableDeviceValues-Schnittstelle , die die Liste der festzulegenden Eigenschaften und Werte enthält.

[out] ppResults

Adresse einer IPortableDeviceValues-Schnittstelle , die die Liste der Eigenschaften empfängt, die erfolgreich festgelegt wurden. Jede Eigenschaft verfügt über einen zugeordneten HRESULT-Wert , der angibt, ob die Einstellung der Eigenschaft erfolgreich war.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Description
S_OK
Die Methode war erfolgreich.
S_FALSE
Fehler bei der Anforderung zum Festlegen einer oder mehrerer der angegebenen Eigenschaften. Überprüfen Sie ppResults , um festzustellen, welche Eigenschaften ggf. erfolgreich sind.
E_POINTER
NULL wurde für ppResults übergeben.

Bemerkungen

Mit dieser Methode können Sie die Werte einer oder mehrerer Eigenschaften angeben, z. B. die Sensorerstellung, das Modell und die Seriennummer, indem Sie einen einzelnen Aufruf ausführen.

Nicht alle Eigenschaften können festgelegt werden.

IPortableDeviceValues wird von der Windows Portable Devices-API definiert.

Examples

Ein Beispiel zum Festlegen von Eigenschaften finden Sie unter Einstellung und Abrufen von Sensoreigenschaften.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Fenster
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

Siehe auch

GetProperties

ISensor