IPortableDeviceContent::Move メソッド (portabledeviceapi.h)

  • [アーティクル]

Move メソッドは、デバイス上のある場所から別の場所に 1 つ以上のオブジェクトを移動します。

構文

HRESULT Move(
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in]      LPCWSTR                              pszDestinationFolderObjectID,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

パラメーター

[in] pObjectIDs

移動するオブジェクトのオブジェクト ID を指定する 1 つ以上の null で終わる文字列 (型VT_LPWSTR) を保持する IPortableDevicePropVariantCollection インターフェイスへのポインター。

[in] pszDestinationFolderObjectID

宛先の ID を指定する null で終わる文字列へのポインター。

[in, out] ppResults

省略可能。 返された場合、このパラメーターには、操作の成功または失敗を示すVT_ERROR値のコレクションが含まれます。 ppResults で返される最初の要素は pObjectIDs コレクションの最初のオブジェクトに対応し、ppResults で返される 2 番目の要素は pObjectIDs コレクション内の 2 番目のオブジェクトに対応します。 アプリケーションが結果に関係しない場合、このパラメーターは NULL にすることができます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。 エラー値が返された場合、デバイスでオブジェクトは削除されませんでした。

リターン コード 説明
S_OK
 メソッドが成功しました。
S_FALSE
 1 つ以上のオブジェクトが削除されましたが、少なくとも 1 つのオブジェクトを削除できませんでした。 削除されなかったオブジェクトについては 、ppFailedObjectIDs を参照してください。
E_ACCESSDENIED
 アプリケーションには、オブジェクトを移動する権限がありません。
E_POINTER
 必要な引数の少なくとも 1 つが NULL ポインターでした。

注釈

指定されたデバイスが機能ストレージでの移動操作をサポートしている場合、 pszDestinationFolderObjectID パラメーターは機能ストレージの識別子を指定できます。

例

この方法の使用例については、「 デバイスでのコンテンツの移動」を参照してください。

要件

要件 値
対象プラットフォーム Windows
ヘッダー portabledeviceapi.h
Library PortableDeviceGUIDs.lib

こちらもご覧ください

IPortableDeviceContent インターフェイス

デバイスでのコンテンツの移動