IWMDMStorageControl::D elete メソッド (mswmdm.h)

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

Delete メソッドは、このストレージを完全に削除します。

構文

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

パラメーター

[in] fuMode

次のフラグのうち 1 つまたは 2 つを、ビットごとの OR と組み合わせて使用 します。最初の 2 つのモードのうちの 1 つを正確に指定します。3 番目のモードは省略可能です。

モード	説明
WMDM_MODE_BLOCK	この操作は、ブロックモード (同期) 処理を使用して実行されます。操作が完了するまで、呼び出しは返されません。
WMDM_MODE_THREAD	この操作は、スレッドモード (非同期) 処理を使用して実行されます。呼び出しはすぐに返され、操作はバックグラウンドスレッドで実行されます。
WMDM_MODE_RECURSIVE	ストレージオブジェクトがフォルダーの場合、そのオブジェクトとその内容、およびすべてのサブフォルダーとその内容が削除されます。

[in] pProgress

Windows Media デバイスマネージャーがアプリケーションに進行状況を報告するために使用する IWMDMProgress インターフェイスへのオプションのポインター。

戻り値

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

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

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

注釈

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

Delete 操作が完了すると、削除されたオブジェクトへのすべての参照が無効になります。アプリケーションは、これらのインターフェイスと、オブジェクトに関連付けられているその他のインターフェイスまたはリソースを解放する必要があります。

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