IMDSPEnumStorage-Schnittstelle (mswmdm.h)

Artikel
02/29/2024

Die IMDSPEnumStorage-Schnittstelle wird verwendet, um die Speichermedien auf einem Gerät aufzulisten. Weitere Informationen zur Standardimplementierung von Enumerationsschnittstellen finden Sie in der Microsoft COM-Dokumentation, die auf der Microsoft-Website verfügbar ist. Die Speichermedien auf einem Gerät sind hierarchisch organisiert, ähnlich wie bei Datenträgern auf einem Computer.

Beim Zugriff über die IMDSPDevice::EnumStorage-Methode listet diese Schnittstelle die einzelnen Speichermedien auf dem Gerät auf die gleiche Weise auf, wie sie die einzelnen Datenträger auf einem Computer sehen würden.

Beim Zugriff über die IWMDMStorage::EnumStorage-Methode listet diese Schnittstelle den Inhalt des Speichermediums auf. EnumStorage kann rekursiv für die enumerierten Speicherobjekte aufgerufen werden, sodass die Inhalte eines Speichermediums auf die hierarchische Weise zurückgegeben werden, in der sie auf dem Speichermedium gespeichert werden. Wenn das Dateisystem des Speichermediums ein Konzept der Reihenfolge zwischen den Inhalten unterstützt, gibt der Enumerator den Inhalt in derselben Reihenfolge zurück.

Der Speicherenumerator gibt eine Momentaufnahme des Speicherstatus zurück. Es spiegelt möglicherweise nicht die Auswirkungen des Einfügens und Entfernens von Speichermedien wider und spiegelt möglicherweise nicht die Auswirkungen der nachfolgenden Insert-, Move- und Delete-Methoden wider. Der Client sollte einen neuen Enumerator abrufen, um den neuen Zustand des Speichermediums abzurufen.

Die Methoden Insert, Move und Delete der IWMDMStorageControl-Schnittstelle ändern die Reihenfolge der Dateien. Wenn diese Vorgänge aufgerufen werden, kann die Reihenfolge der Objekte geändert werden, die ursprünglich von der IMDSPEnumStorage-Schnittstelle zurückgegeben wurden.

Wenn eine Anwendung die Reihenfolge der Inhalte auf einem Mediengerät anzeigt, muss der Anwendungsprogrammierer Die Reihenfolgenänderungen berücksichtigen, die als Folge von IWMDMStorageControl-Vorgängen auftreten können. Es gibt zwei Möglichkeiten, mit dieser Situation umzugehen. Eine Möglichkeit besteht darin, einfach neu aufzuzählen, wenn eine Änderung des Inhalts auftritt. Eine weitere Möglichkeit besteht darin, die Reihenfolge von IWMDMStorage-Objekten programmgesteuert beizubehalten.

Unabhängig davon, wie dieses Problem behandelt wird, muss es von der Anwendung behandelt werden, wenn die Reihenfolge der Dateien für die Anwendung wichtig ist.

Vererbung

Die IMDSPEnumStorage-Schnittstelle erbt von der IUnknown-Schnittstelle . IMDSPEnumStorage verfügt auch über folgende Membertypen:

Methoden

Die IMDSPEnumStorage-Schnittstelle verfügt über diese Methoden.


IMDSPEnumStorage::Clone Die Clone-Methode erstellt einen weiteren Enumerator, der den gleichen Enumerationszustand wie der aktuelle enthält. (IMDSPEnumStorage.Clone)
IMDSPEnumStorage::Next Die Next-Methode gibt einen Zeiger auf die nächsten celtIMDSPStorage-Schnittstellen zurück.
IMDSPEnumStorage::Reset Die Reset-Methode setzt die Enumerationssequenz an den Anfang zurück. Bei einem nachfolgenden Aufruf der Next-Methode wird die erste Speicherschnittstelle in der Enumerationssequenz abgerufen.
IMDSPEnumStorage::Skip Die Skip-Methode überspringt die nächste angegebene Anzahl von Speicherschnittstellen in der Enumerationssequenz.