Método IVdsService::CleanupObsoleteMountPoints (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.]
Remove caminhos do modo de usuário e pastas montadas para volumes que não existem mais.
Sintaxe
HRESULT CleanupObsoleteMountPoints();
Retornar valor
Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou 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 |
|---|---|
|
Caminhos desatualizados do modo de usuário e pastas montadas foram removidos com êxito. |
|
Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço termine de inicializar, o método será bloqueado até que a inicialização seja concluída. Se a inicialização falhar, esse erro será retornado. |
Comentários
Por padrão, o Registro retém as informações de mapeamento de letra da unidade para volumes desinstalados. Se o disco que contém o volume for removido do computador, a entrada do Registro será mantida, de modo que, se o disco e o volume retornarem ao mesmo computador, o volume receberá a mesma letra da unidade. Se o disco for movido para um novo computador, as entradas do Registro não serão movidas com ele, portanto, o volume poderá receber uma letra da unidade e um GUID de volume diferentes.
O método CleanupObsoleteMountPoints remove essas entradas do Registro. Há três tipos de entradas do Registro que são removidas:
- Se o volume não tiver uma letra da unidade ou um GUID de volume, ele terá uma entrada do Registro "sem letra da unidade", que é removida por esse método.
- Caso contrário, o volume tem entradas do Registro para um GUID de volume e, possivelmente, uma letra da unidade. Ambos são removidos por esse método.
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 |