IMDSPEnumStorage インターフェイス (mswmdm.h)

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

IMDSPEnumStorage インターフェイスは、デバイス上のストレージメディアを列挙するために使用されます。列挙インターフェイスの標準実装の詳細については、Microsoft Web サイトで入手できる Microsoft COM ドキュメントを参照してください。デバイス上のストレージメディアは、コンピューター上のディスクドライブと同様に階層的に編成されます。

IMDSPDevice::EnumStorage メソッドからアクセスすると、このインターフェイスは、コンピューター上の個々のディスクドライブを表示するのと同じ方法で、デバイス上の個々の記憶域メディアを列挙します。

IWMDMStorage::EnumStorage メソッドからアクセスすると、このインターフェイスはストレージメディアの内容を列挙します。列挙されたストレージオブジェクトで EnumStorage を再帰的に呼び出すことができるため、ストレージメディアの内容は、ストレージメディアに格納される階層的な方法で返されます。ストレージメディアのファイルシステムがコンテンツ間の順序の概念をサポートしている場合、列挙子はコンテンツを同じ順序で返します。

ストレージ列挙子は、ストレージの状態のスナップショットを返します。記憶域メディアの挿入と削除の効果が反映されない場合があり、後続の Insert、 Move 、 Delete メソッドの効果が反映されない場合があります。クライアントは、ストレージメディアの新しい状態を取得するために新しい列挙子を取得する必要があります。

IWMDMStorageControl インターフェイスの Insert、Move、Delete メソッドは、ファイルの順序を変更します。これらの操作が呼び出された場合、 IMDSPEnumStorage インターフェイスによって最初に返されたオブジェクトの順序を変更できます。

アプリケーションがメディアデバイス上のコンテンツの順序を表示する場合、アプリケーションプログラマは 、IWMDMStorageControl 操作の結果として発生する可能性がある順序の変更を考慮する必要があります。この状況に対処するには、2 つの方法があります。 1 つの方法は、コンテンツに対する変更が発生するたびに、単に再列挙することです。もう 1 つの方法は、 IWMDMStorage オブジェクトの順序をプログラムで維持することです。

この問題がどのように処理されても、ファイルの順序がアプリケーションにとって重要な場合は、アプリケーションで処理する必要があります。

継承

IMDSPEnumStorage インターフェイスは、IUnknown インターフェイスから継承されます。 IMDSPEnumStorage には、次の種類のメンバーもあります。

メソッド

IMDSPEnumStorage インターフェイスには、これらのメソッドがあります。


IMDSPEnumStorage::Clone Clone メソッドは、現在の列挙状態と同じ列挙状態を含む別の列挙子を作成します。 (IMDSPEnumStorage.Clone)
IMDSPEnumStorage::Next Next メソッドは、次の celtIMDSPStorage インターフェイスへのポインターを返します。
IMDSPEnumStorage::Reset Reset メソッドは、列挙シーケンスを先頭にリセットします。 Next メソッドの後続の呼び出しは、列挙シーケンス内の最初のストレージインターフェイスをフェッチします。
IMDSPEnumStorage::Skip Skip メソッドは、列挙シーケンス内の次に指定された数のストレージインターフェイスをスキップします。