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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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. |
|
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 |