共用方式為

IPortableDeviceContent2：：UpdateObjectWithPropertiesAndData 方法 (portabledeviceapi.h)

  • 發行項

UpdateObjectWithPropertiesAndData 方法會使用裝置上找到的屬性和數據來更新物件。

語法

HRESULT UpdateObjectWithPropertiesAndData(
  [in]      LPCWSTR               pszObjectID,
  [in]      IPortableDeviceValues *pProperties,
  [out]     IStream               **ppData,
  [in, out] DWORD                 *pdwOptimalWriteBufferSize
);

參數

[in] pszObjectID

要更新之物件的標識碼。

[in] pProperties

IPortableDeviceValues 介面，指定要更新的物件屬性。

[out] ppData

將對象數據傳送至裝置的 IStream 介面。

[in, out] pdwOptimalWriteBufferSize

將對象數據寫入 ppData 的最佳緩衝區大小，如果忽略緩衝區大小，則為 NULL 。

傳回值

如果方法成功，它會 傳回S_OK。 任何其他 HRESULT 值都表示呼叫失敗。

備註

裝置格式和物件格式可以從數據本身衍生一些物件屬性。 或者，它們可以有相依於數據的屬性值。 例如，當應用程式呼叫 IPortableDeviceContent：：CreateObjectWithPropertiesAndData 方法時，音樂播放軌具有指定的持續時間屬性。 如果此追蹤儲存為預設資源 (WPD_RESOURCE_DEFAULT) ，應用程式可能會更新它。 應用程式也會額外儲存以更新 duration 屬性。 這個方法可讓應用程式同時執行這兩個更新。

更新不完整，直到在ppData參數所參考的物件上呼叫IStream：：Commit 方法為止。

若要放棄進行中的數據傳輸，應用程式應該在 ppData 參數所參考的物件上呼叫 IStream：：Revert 方法。

ppData 參數所參考的 IStream 介面對象必須在更新作業完成或取消之後釋放。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 portabledeviceapi.h