Método IVdsSubSystem::Reenumerate (vds.h)
[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]
Solicita que o subsistema examine seu barramento para descobrir unidades recém-conectadas ou unidades recém-desconectadas.
Sintaxe
HRESULT Reenumerate();
Retornar valor
Esse método pode retornar valores HRESULT padrão, como E_OUTOFMEMORY e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.
| Valor/código retornado | Descrição |
|---|---|
|
Esse valor retornado sinaliza um problema de software ou comunicação dentro de um provedor que armazena em cache informações sobre a matriz. Use o método IVdsHwProvider::Reenumerate seguido pelo método IVdsHwProvider::Refresh para restaurar o cache. |
|
O objeto do subsistema não está mais presente. |
|
O subsistema está em um estado de falha e não consegue executar a operação solicitada. |
|
Outra operação está em andamento; essa operação não pode continuar até que a operação ou as operações anteriores sejam concluídas. |
Comentários
A maioria dos subsistemas detecta novas conexões e desconexões automaticamente. No entanto, para aqueles que não o fazem, esse método fornece um meio pelo qual iniciar a detecção manualmente. Essa operação pode levar muito tempo para ser concluída.
Quando esse método detecta uma unidade conectada recentemente, o provedor cria um novo objeto de unidade para ele. Quando o método detecta uma unidade recém-desconectada, o provedor preserva o objeto de unidade antigo até que sua última referência de VDS seja removida e, em seguida, exclui o objeto .
Cada objeto deve ter um identificador exclusivo e persistente. Uma ID de objeto deve ser um GUID válido. Os implementadores devem persistir uma ID de objeto em cada reenumeração usando esse método para objetos que existem antes e depois da reenumeração.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vds.h |
| Biblioteca | Uuid.lib |