ISensor::SetProperties-Methode (sensorsapi.h)

Gibt Sensoreigenschaften an.

Syntax

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

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 das Festlegen der Eigenschaft erfolgreich war.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
S_FALSE	Bei der Anforderung zum Festlegen einer oder mehrerer der angegebenen Eigenschaften ist ein Fehler aufgetreten. Überprüfen Sie ppResults , um zu ermitteln, welche Eigenschaften erfolgreich waren.
E_POINTER	NULL wurde für ppResults übergeben.

Hinweise

Mit dieser Methode können Sie die Werte einer oder mehrerer Eigenschaften angeben, z. B. sensor make, model und serial number, indem Sie einen einzelnen Aufruf ausführen.

Nicht alle Eigenschaften können festgelegt werden.

IPortableDeviceValues wird von der Windows Portable Devices-API definiert.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	sensorsapi.h
Bibliothek	Sensorsapi.lib
DLL	Sensorsapi.dll

Weitere Informationen

GetProperties

ISensor