IPortableDeviceProperties：：GetValues 方法 (portabledeviceapi.h)

發行項
03/05/2024

GetValues 方法會從裝置上的指定物件擷取指定的屬性清單。

語法

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

參數

[in] pszObjectID

Null 終止字串的指標，其中包含要查詢之對象的標識碼。若要指定裝置，請使用 WPD_DEVICE_OBJECT_ID。

[in] pKeys

IPortableDeviceKeyCollection 介面的指標，其中包含要查詢的一或多個屬性。如果這是 NULL，則會擷取所有屬性。如需 Windows 可攜式裝置所定義的屬性清單，請參閱屬性和屬性。

[out] ppValues

接收 IPortableDeviceValues 介面指標的變數位址，其中包含要求的屬性值。這些值會以 PROPERTYKEY/value 組的形式傳回，其中值的數據類型取決於屬性。如果因某些原因而無法擷取值，傳回的類型將會VT_ERROR，並包含描述擷取錯誤的 HRESULT 值。呼叫端必須在完成此介面時釋放此介面。

傳回值

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

傳回碼	描述
S_OK	已擷取所有要求的屬性值。
S_FALSE	無法擷取一或多個屬性值。問題屬性會在擷取的 ppValues 參數中具有HRESULT值。