IWMDMStorageControl::Rename メソッド (mswmdm.h)

[アーティクル]
08/25/2023

Rename メソッドは、現在のストレージの名前を変更します。

構文

HRESULT Rename(
  [in] UINT          fuMode,
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

パラメーター

[in] fuMode

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

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

[in] pwszNewName

新しい名前を指定するワイド文字の null で終わる文字列へのポインター。

[in] pProgress

アクションの進行状況を追跡するためにアプリケーションによって実装された IWMDMProgress インターフェイスへのオプションのポインター。

戻り値

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

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

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

注釈

WMDM_MODE_THREAD フラグが指定されている場合は、IWMDMProgress2::End2 または IWMDMProgress3::End3 を呼び出して完了状態を取得する必要があります。これらのメソッドを使用すると、操作が完了し、成功または失敗の情報を含む HRESULT も返されます。

アプリケーションで WMDM_MODE_THREADを使用し、null 以外の pProgress パラメーターを渡す場合、Windows Media デバイスマネージャーはこのオブジェクトに進行状況通知を送信するため、pProgress が属するオブジェクトが読み取り操作が完了するまで破棄されないようにする必要があります。このオブジェクトは、End 通知を受信した後にのみ破棄できます。これを行わないと、アクセス違反が発生します。