共用方式為

ISensor：：GetProperties 方法 （sensorsapi.h）

這很重要

請改用 UWP 感應器 API 。

COM 型感測器 API 已被取代，不應該用於新的應用程式。 沒有計劃提供其他功能或增強功能，並且支援將受到限制。

擷取多個感應器屬性。

語法

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

參數

[in] pKeys

IPortableDeviceKeyCollection 介面的指標，其中包含所要求屬性值的 PROPERTYKEY 集合。 設定為 Null 以擷取所有支援的屬性。

[out] ppProperties

IPortableDeviceValues 指標的位址，可接收所要求屬性值的指標。

返回值

這個方法會傳回 HRESULT。 可能的值包括但不限於下表中的值。

回傳碼 Description
S_OK
 方法成功了。
S_FALSE
 感應器驅動程式不支援至少一個指定的屬性。 透過 IPortableDeviceValues 介面傳回的每個不支援的屬性 PROPVARIANT 都會將其錯誤值設定為 HRESULT_FROM_WIN32 （ERROR_NOT_FOUND）。
E_POINTER
 已針對 ppProperties 傳入 NULL。

備註

這個方法可讓您透過進行單一呼叫來擷取多個屬性的值，例如感測器品牌、型號和序號。 若要擷取單一屬性，請呼叫 ISensor：：GetProperty。

IPortableDeviceKeyCollection 和 IPortableDeviceValues 介面是由 Windows 可攜式裝置 API 所定義。

範例

如需如何從感應器擷取屬性的範例，請參閱 設定和擷取感應器屬性。

需求

Requirement 價值觀
最低支援的用戶端 Windows 7 [僅限桌面應用程式]
支援的最低伺服器 不支援
目標平臺 窗戶
Header 傳感器API.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

另請參閱

ISensor

感測器屬性

設定屬性

  • Last updated on