デバイスでのコンテンツの移動
WPD アプリケーションによって実行されるもう 1 つの一般的な操作は、デバイス上のある場所から別の場所へのコンテンツの転送です。
コンテンツ移動操作は、次の表で説明するインターフェイスを使用して実行されます。
| インターフェイス | 説明 |
|---|---|
| IPortableDeviceContent インターフェイス | コンテンツ固有のメソッドへのアクセスを提供します。 |
| IPortableDevicePropVariantCollection インターフェイス | プロパティ固有のメソッドへのアクセスを提供します。 |
サンプル アプリケーションの ContentTransfer.cpp モジュールの MoveContentAlreadyOnDevice 関数は、アプリケーションがコンテンツをある場所から別の場所に移動する方法を示しています。
MoveContentAlreadyOnDevice 関数によって実行される最初のタスクは、デバイス ドライバーに対してクエリを実行して、コンテンツの移動をサポートしているかどうかを確認することです。 これは、SupportsCommand ヘルパー関数を呼び出し、WPD_COMMAND_OBJECT_MANAGEMENT_MOVE_OBJECTSを 2 番目の引数として渡すことによって実現されます。
HRESULT hr = S_OK;
WCHAR wszSelection[81] = {0};
WCHAR wszDestinationFolderObjectID[81] = {0};
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IPortableDevicePropVariantCollection> pObjectsToMove;
CComPtr<IPortableDevicePropVariantCollection> pObjectsFailedToMove;
if (SupportsCommand(pDevice, WPD_COMMAND_OBJECT_MANAGEMENT_MOVE_OBJECTS) == FALSE)
{
printf("! This device does not support the move operation (i.e. The WPD_COMMAND_OBJECT_MANAGEMENT_MOVE_OBJECTS command)\n");
return;
}
次の手順では、ユーザーに 2 つのオブジェクト識別子の入力を求める必要があります。 1 つ目は、移動されるコンテンツの識別子です。 2 つ目は、アプリケーションがこのコンテンツを移動する場所の識別子です。
HRESULT hr = S_OK;
WCHAR wszSelection[81] = {0};
WCHAR wszDestinationFolderObjectID[81] = {0};
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IPortableDevicePropVariantCollection> pObjectsToMove;
CComPtr<IPortableDevicePropVariantCollection> pObjectsFailedToMove;
printf("Enter the identifer of the object you wish to move.\n>");
hr = StringCbGetsW(wszSelection,sizeof(wszSelection));
if (FAILED(hr))
{
printf("An invalid object identifier was specified, aborting content moving\n");
}
// Prompt user to enter an object identifier on the device to move.
printf("Enter the identifer of the object you wish to move '%ws' to.\n>", wszSelection);
hr = StringCbGetsW(wszDestinationFolderObjectID,sizeof(wszDestinationFolderObjectID));
if (FAILED(hr))
{
printf("An invalid object identifier was specified, aborting content moving\n");
}
次に、 IPortableDeviceContent ::Move メソッドへのアクセスに使用される IPortableDeviceContent オブジェクトを取得します。
HRESULT hr = S_OK;
WCHAR wszSelection[81] = {0};
WCHAR wszDestinationFolderObjectID[81] = {0};
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IPortableDevicePropVariantCollection> pObjectsToMove;
CComPtr<IPortableDevicePropVariantCollection> pObjectsFailedToMove;
if (SUCCEEDED(hr))
{
hr = pDevice->Content(&pContent);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceContent from IPortableDevice, hr = 0x%lx\n",hr);
}
}
最後に、コンテンツが移動されます。 このプロセスには、次の処理が含まれます。
- 移動するオブジェクトの PROPVARIANT 構造体を受け取る IPortableDevicePropVariantCollection オブジェクトを作成します。
- IPortableDevicePropVariantCollection オブジェクトに PROPVARIANT を追加します。
- IPortableDeviceContent::Move メソッドの呼び出し。
HRESULT hr = S_OK;
WCHAR wszSelection[81] = {0};
WCHAR wszDestinationFolderObjectID[81] = {0};
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IPortableDevicePropVariantCollection> pObjectsToMove;
CComPtr<IPortableDevicePropVariantCollection> pObjectsFailedToMove;
if (SUCCEEDED(hr))
{
hr = CoCreateInstance(CLSID_PortableDevicePropVariantCollection,
NULL,
CLSCTX_INPROC_SERVER,
IID_IPortableDevicePropVariantCollection,
(VOID**) &pObjectsToMove);
if (SUCCEEDED(hr))
{
if (pObjectsToMove != NULL)
{
PROPVARIANT pv = {0};
PropVariantInit(&pv);
// Initialize a PROPVARIANT structure with the object identifier string
// that the user selected above. Notice we are allocating memory for the
// LPWSTR value. This memory will be freed when PropVariantClear() is
// called below.
pv.vt = VT_LPWSTR;
pv.pwszVal = AtlAllocTaskWideString(wszSelection);
if (pv.pwszVal != NULL)
{
// Add the object identifier to the objects-to-move list
// (We are only moving 1 in this example)
hr = pObjectsToMove->Add(&pv);
if (SUCCEEDED(hr))
{
// Attempt to move the object on the device
hr = pContent->Move(pObjectsToMove, // Object(s) to move
wszDestinationFolderObjectID, // Folder to move to
NULL); // Object(s) that failed to delete (we are only moving 1, so we can pass NULL here)
if (SUCCEEDED(hr))
{
// An S_OK return lets the caller know that the deletion was successful
if (hr == S_OK)
{
printf("The object '%ws' was moved on the device.\n", wszSelection);
}
// An S_FALSE return lets the caller know that the move failed.
// The caller should check the returned IPortableDevicePropVariantCollection
// for a list of object identifiers that failed to be moved.
else
{
printf("The object '%ws' failed to be moved on the device.\n", wszSelection);
}
}
else
{
printf("! Failed to move an object on the device, hr = 0x%lx\n",hr);
}
}
else
{
printf("! Failed to move an object on the device because we could no add the object identifier string to the IPortableDevicePropVariantCollection, hr = 0x%lx\n",hr);
}
}
else
{
hr = E_OUTOFMEMORY;
printf("! Failed to move an object on the device because we could no allocate memory for the object identifier string, hr = 0x%lx\n",hr);
}
// Free any allocated values in the PROPVARIANT before exiting
PropVariantClear(&pv);
}
else
{
printf("! Failed to move an object from the device because we were returned a NULL IPortableDevicePropVariantCollection interface pointer, hr = 0x%lx\n",hr);
}
}
else
{
printf("! Failed to CoCreateInstance CLSID_PortableDevicePropVariantCollection, hr = 0x%lx\n",hr);
}
}
関連トピック