Интерфейс IMDSPEnumStorage (mswmdm.h)
Интерфейс IMDSPEnumStorage используется для перечисления носителей на устройстве. Дополнительные сведения о стандартной реализации интерфейсов перечисления см. в документации microsoft COM, доступной на веб-сайте Майкрософт. Носитель на устройстве организован в иерархическом порядке, аналогично дискам на компьютере.
При доступе из метода IMDSPDevice::EnumStorage этот интерфейс перечисляет отдельные носители на устройстве так же, как вы увидите отдельные диски на компьютере.
При обращении из метода IWMDMStorage::EnumStorage этот интерфейс перечисляет содержимое среды хранения. EnumStorage может вызываться для перечисленных объектов хранилища рекурсивно, поэтому содержимое среды хранения возвращается иерархическим образом, в котором они хранятся на носителе. Если файловая система носителя хранилища поддерживает понятие порядка между содержимым, перечислитель вернет содержимое в том же порядке.
Перечислитель хранилища возвращает snapshot состояния хранилищ. Он может не отражать эффект вставки и удаления носителей хранилища, а также эффекты последующих методов Insert, Move и Delete . Клиент должен получить новый перечислитель, чтобы получить новое состояние носителя хранилища.
Методы Insert, Move и Delete интерфейса IWMDMStorageControl изменяют порядок файлов. При вызове этих операций можно изменить порядок объектов, возвращаемых интерфейсом IMDSPEnumStorage .
Если приложение собирается отобразить порядок содержимого на устройстве мультимедиа, программист приложения должен учитывать изменения порядка, которые могут произойти в результате операций IWMDMStorageControl . Существует два способа решения этой ситуации. Одним из способов является простое повторное перечисление при каждом изменении содержимого. Другой способ — программное поддержание порядка объектов IWMDMStorage .
Независимо от того, как эта проблема устранена, она должна быть обработана приложением, если порядок файлов важен для приложения.
Наследование
Интерфейс IMDSPEnumStorage наследуется от интерфейса IUnknown . IMDSPEnumStorage также имеет следующие типы элементов:
Методы
Интерфейс IMDSPEnumStorage содержит следующие методы.
| IMDSPEnumStorage::Clone Метод Clone создает еще один перечислитель, содержащий то же состояние перечисления, что и текущее. (IMDSPEnumStorage.Clone) |
| IMDSPEnumStorage::Next Метод Next возвращает указатель на следующие интерфейсы celtIMDSPStorage. |
| IMDSPEnumStorage::Reset Метод Reset сбрасывает последовательность перечисления до начала. Последующий вызов метода Next извлекает первый интерфейс хранилища в последовательности перечисления. |
| IMDSPEnumStorage::Skip Метод Skip пропускает следующее указанное число интерфейсов хранения в последовательности перечисления. |
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | mswmdm.h |