次の方法で共有

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 メソッドを呼び出すときに指定される duration プロパティがあります。 このトラックが既定のリソース (WPD_RESOURCE_DEFAULT) として格納されている場合、アプリケーションによって更新される可能性があります。 さらに、アプリケーションは duration プロパティを更新する必要があります。 このメソッドを使用すると、アプリケーションで両方の更新を同時に実行できます。

ppData パラメーターによって参照されるオブジェクトに対して IStream::Commit メソッドが呼び出されるまで、更新は不完全です。

進行中のデータ転送を破棄するには、アプリケーションで ppData パラメーターによって参照されるオブジェクトに対して IStream::Revert メソッドを呼び出す必要があります。

ppData パラメーターによって参照される IStream インターフェイス オブジェクトは、更新操作が完了した後、または取り消された後に解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー portabledeviceapi.h