IPortableDeviceProperties：：SetValues 方法 (portabledeviceapi.h)

SetValues方法會在裝置上的指定物件上新增或修改一或多個屬性。

語法

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

[in] pszObjectID

Null 終止字串的指標，其中包含要修改之物件的物件識別碼。若要指定裝置，請使用 WPD_DEVICE_OBJECT_ID。

[in] pValues

IPortableDeviceValues介面的指標，其中包含要設定的一或多個屬性/值組。將會覆寫現有的值。

[out] ppResults

接收 IPortableDeviceValues 介面指標的變數位址，其中包含屬性/HRESULT 值的集合。每個值 (類型VT_ERROR) 描述屬性集嘗試的成功或失敗。呼叫端必須在完成此介面時釋放此介面。

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

傳回碼	描述
S_OK	所有指定的屬性值都已更新。
S_FALSE	無法修改一或多個屬性。在擷取的ppResults參數中，無法有類型為 VT_ERROR 的HRESULT。

若要刪除屬性，請呼叫 IPortableDeviceProperties：:D elete。只有在屬性的WPD_PROPERTY_ATTRIBUTE_CAN_WRITE屬性為 True 時，才能刪除屬性。呼叫 GetPropertyAttributes即可擷取這個屬性。

如需如何使用此方法的範例，請參閱設定單一物件的屬性。