IMDSPObject::Move メソッド (mswmdm.h)

Move メソッドは、メディアデバイス上のファイルまたはフォルダーを移動します。

構文

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress,
  [in] IMDSPStorage  *pTarget
);

[in] fuMode

Move 操作を呼び出す処理モードと、移動するメソッド。次の 2 つのモードのいずれかを正確に指定します。両方のモードが指定されている場合は、ブロックモードが使用されます。

モード	説明
WMDM_MODE_BLOCK	この操作は、ブロックモード処理を使用して実行されます。操作が完了するまで、呼び出しは戻りません。
WMDM_MODE_THREAD	操作はスレッドモード処理を使用して実行されます。呼び出しはすぐに返され、操作はバックグラウンドスレッドで実行されます。

次の表に、オブジェクトの移動先を示すフラグの一覧を示します。このテーブルの 1 つの値は、ビットごとの OR を使用して、前の Mode テーブルの 1 つの値と組み合わされます。

移動方法	説明
WMDM_STORAGECONTROL_INSERTBEFORE	オブジェクトはターゲットオブジェクトの前に挿入されます。
WMDM_STORAGECONTROL_INSERTINTO	オブジェクトがターゲットオブジェクトに挿入されます。ターゲットオブジェクトはフォルダーである必要があります。ターゲットオブジェクトがファイルの場合、このメソッドは失敗します。
WMDM_STORAGECONTROL_INSERTAFTER	オブジェクトは、ターゲットオブジェクトの後に挿入されます。

[in] pProgress

進行中の操作の進行状況を追跡するためにアプリケーションによって実装された IWMDMProgress インターフェイスへのポインター。このパラメーターは省略可能であり、使用しない場合は NULL に設定する必要があります。

[in] pTarget

現在のオブジェクトを配置する前または後のターゲットオブジェクトへのポインター。

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

ファイルまたはディレクトリは、同じルートストレージ内でのみ移動できます。このメソッドが呼び出されるオブジェクトは、新しい場所を反映するように更新する必要があります。

このメソッドは省略可能です。詳細については、「必須インターフェイスとオプションインターフェイス」を参照してください。