Interface IMDSPEnumStorage (mswmdm.h)

Artigo
08/25/2023

A interface IMDSPEnumStorage é usada para enumerar a mídia de armazenamento em um dispositivo. Para obter mais informações sobre a implementação padrão de interfaces de enumeração, consulte a documentação do Microsoft COM, disponível no site da Microsoft. A mídia de armazenamento em um dispositivo é organizada de maneira hierárquica semelhante às unidades de disco em um computador.

Quando acessada do método IMDSPDevice::EnumStorage , essa interface enumera a mídia de armazenamento individual no dispositivo da mesma forma que você veria as unidades de disco individuais em um computador.

Quando acessado do método IWMDMStorage::EnumStorage , essa interface enumera o conteúdo do meio de armazenamento. EnumStorage pode ser chamado nos objetos de armazenamento enumerados recursivamente e, portanto, o conteúdo de um meio de armazenamento é retornado da maneira hierárquica em que eles são armazenados no meio de armazenamento. Se o sistema de arquivos da mídia de armazenamento der suporte a uma noção de ordem entre o conteúdo, o enumerador retornará o conteúdo na mesma ordem.

O enumerador de armazenamento retorna uma instantâneo do estado dos armazenamentos. Ele pode não refletir o efeito da inserção e remoção da mídia de armazenamento e pode não refletir os efeitos dos métodos Insert, Move e Delete subsequentes. O cliente deve obter um novo enumerador para obter o novo estado da mídia de armazenamento.

Os métodos Insert, Move e Delete da interface IWMDMStorageControl alteram a ordem dos arquivos. Se essas operações forem invocadas, a ordem dos objetos, conforme retornado originalmente pela interface IMDSPEnumStorage , poderá ser alterada.

Se um aplicativo vai exibir a ordem do conteúdo em um dispositivo de mídia, o programador de aplicativos deve levar em conta as alterações de ordem que podem ocorrer como resultado de operações IWMDMStorageControl . Há duas maneiras de lidar com essa situação. Uma maneira é simplesmente renumerar sempre que ocorrer uma alteração no conteúdo. Outra maneira é manter a ordem dos objetos IWMDMStorage programaticamente.

Não importa como esse problema é tratado, ele deve ser tratado pelo aplicativo se a ordem dos arquivos for importante para o aplicativo.

Herança

A interface IMDSPEnumStorage herda da interface IUnknown . IMDSPEnumStorage também tem estes tipos de membros:

Métodos

A interface IMDSPEnumStorage tem esses métodos.


IMDSPEnumStorage::Clone O método Clone cria outro enumerador que contém o mesmo estado de enumeração que o atual. (IMDSPEnumStorage.Clone)
IMDSPEnumStorage::Next O método Next retorna um ponteiro para as próximas interfaces celtIMDSPStorage.
IMDSPEnumStorage::Reset O método Reset redefine a sequência de enumeração para o início. Uma chamada subsequente para o método Next busca a primeira interface de armazenamento na sequência de enumeração.
IMDSPEnumStorage::Skip O método Skip ignora o próximo número especificado de interfaces de armazenamento na sequência de enumeração.