ISensor::GetProperties-Methode (sensorsapi.h)

Ruft mehrere Sensoreigenschaften ab.

Syntax

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Parameter

[in] pKeys

Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die die PROPERTYKEY-Auflistung für die angeforderten Eigenschaftswerte enthält. Legen Sie auf NULL fest, um alle unterstützten Eigenschaften abzurufen.

[out] ppProperties

Adresse eines IPortableDeviceValues-Zeigers , der den Zeiger auf die angeforderten Eigenschaftswerte empfängt.

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	Der Sensortreiber unterstützt nicht mindestens eine der angegebenen Eigenschaften. Für jede nicht unterstützte Eigenschaft PROPVARIANT , die über die IPortableDeviceValues-Schnittstelle zurückgegeben wird, ist der Fehlerwert auf HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) festgelegt.
E_POINTER	NULL wurde für ppProperties übergeben.

Hinweise

Mit dieser Methode können Sie die Werte mehrerer Eigenschaften abrufen, z. B. die Sensorherstellung, das Modell und die Seriennummer, indem Sie einen einzelnen Aufruf tätigen. Um eine einzelne Eigenschaft abzurufen, rufen Sie ISensor::GetProperty auf.

Die Schnittstellen IPortableDeviceKeyCollection und IPortableDeviceValues werden von der Windows Portable Devices-API definiert.

Beispiele

Ein Beispiel zum Abrufen von Eigenschaften von einem Sensor 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

ISensor

Sensoreigenschaften

SetProperties