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

  • [アーティクル]

Copy メソッドは、デバイス上のある場所から別の場所にオブジェクトをコピーします。

構文

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

パラメーター

pObjectIDs

このメソッドがコピーするオブジェクトのオブジェクト識別子のコレクション。

pszDestinationFolderObjectID

このメソッドが指定したオブジェクトをコピーするコピー先フォルダー (または機能ストレージ) のオブジェクト識別子。

[out] ppResults

特定の要素のコピーの成功または失敗を示すVT_ERROR値のコレクション。 最初のエラー値は、オブジェクト識別子のコレクション内の最初のオブジェクトに対応し、2 番目のオブジェクトは 2 番目の要素に対応しています。 この引数には NULL を指定できます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
S_FALSE
 少なくとも 1 つのオブジェクトに対してコピー操作が失敗しました。
E_ACCESSDENIED
 アプリケーションには、指定したオブジェクトの 1 つをコピーする権限がありません。

注釈

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

要件

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

こちらもご覧ください

IPortableDeviceContent インターフェイス