ISensor：：GetProperties 方法 (sensorsapi.h)
擷取多個感測器屬性。
語法
HRESULT GetProperties(
[in] IPortableDeviceKeyCollection *pKeys,
[out] IPortableDeviceValues **ppProperties
);
參數
[in] pKeys
IPortableDeviceKeyCollection 介面的指標，其中包含所要求屬性值的 PROPERTYKEY 集合。 設定為 NULL 以擷取所有支持的屬性。
[out] ppProperties
接收所要求屬性值指標的 IPortableDeviceValues 指標位址。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
感測器驅動程式不支援至少一個指定的屬性。 透過 IPortableDeviceValues 介面傳回的每個不支援屬性 PROPVARIANT 都會將其錯誤值設定為 HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 。 |
|
已針對ppProperties傳入NULL。 |
備註
這個方法可讓您藉由呼叫單一呼叫來擷取多個屬性的值，例如感測器製作、模型和序號。 若要擷取單一屬性，請呼叫 ISensor：：GetProperty。
IPortableDeviceKeyCollection 和 IPortableDeviceValues 介面是由 Windows 可攜式裝置 API 所定義。
範例
如需如何從感測器擷取屬性的範例，請參閱 設定和擷取感測器屬性。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | sensorsapi.h |
| 程式庫 | Sensorsapi.lib |
| Dll | Sensorsapi.dll |