Método IVdsVolume::D elete (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.]
Exclui o volume e todos os plexes, liberando as extensões.
Sintaxe
HRESULT Delete(
[in] BOOL bForce
);
Parâmetros
[in] bForce
Se TRUE, o VDS excluirá o volume mesmo que ele esteja em uso; caso contrário, o volume não será excluído se estiver em uso.
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 se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
Os plexes foram excluídos com êxito. |
Comentários
Você só pode excluir volumes de um pacote online. Use o método IVdsPack::GetProperties para confirmar se o status do pacote está VDS_PS_ONLINE.
Não é possível excluir um volume que esteja na mídia removível.
O VDS desmonta o sistema de arquivos antes de excluir um volume — uma operação exigida por FAT e FAT32, mas não NTFS. Além disso, o VDS exclui todos os caminhos de acesso para o volume depois de excluir o próprio volume. Se a operação de desmontagem falhar e bForce for true, o VDS excluirá o volume sem desmontar. Os aplicativos cliente do sistema de arquivos devem lidar com essa situação. Se a desmontagem for bem-sucedida e a operação de exclusão falhar, o VDS tentará remontar o volume.
O VDS impede a exclusão do sistema atual e dos volumes de inicialização, bem como os volumes pagefile, crashdump e hibernação. Você pode mover ou redefinir o arquivo de página e o carimbo de página. O volume de hibernação deve permanecer na partição de inicialização.
Windows Server 2003: Os volumes crashdump e hibernate devem permanecer na partição de inicialização.
Windows Server 2003: Depois que o volume for excluído, o VDS tentará excluir as pastas montadas. Se isso falhar, Delete retornará VDS_S_ACCESS_PATH_NOT_DELETED, mesmo que o volume tenha sido excluído com êxito.
Requisitos
| 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 |