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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。 エラー値が返された場合、デバイスでオブジェクトは削除されませんでした。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
1 つ以上のオブジェクトが削除されましたが、少なくとも 1 つのオブジェクトを削除できませんでした。 削除されなかったオブジェクトについては 、ppFailedObjectIDs を参照してください。 |
|
アプリケーションには、オブジェクトを移動する権限がありません。 |
|
必要な引数の少なくとも 1 つが NULL ポインターでした。 |
注釈
指定されたデバイスが機能ストレージでの移動操作をサポートしている場合、 pszDestinationFolderObjectID パラメーターは機能ストレージの識別子を指定できます。
例
この方法の使用例については、「 デバイスでのコンテンツの移動」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |