Função ExpandVirtualDisk (virtdisk.h)

  • Artigo

Aumenta o tamanho de um VHD (disco rígido virtual) fixo ou expansível dinamicamente.

Sintaxe

DWORD ExpandVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in]           EXPAND_VIRTUAL_DISK_FLAG        Flags,
  [in]           PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

Parâmetros

[in] VirtualDiskHandle

Um identificador para o disco virtual aberto, que deve ter sido aberto usando o sinalizador VIRTUAL_DISK_ACCESS_METAOPS . Para obter informações sobre como abrir um disco virtual, consulte a função OpenVirtualDisk .

[in] Flags

Deve ser o valor EXPAND_VIRTUAL_DISK_FLAG_NONE da enumeração EXPAND_VIRTUAL_DISK_FLAG .

[in] Parameters

Um ponteiro para uma estrutura de EXPAND_VIRTUAL_DISK_PARAMETERS válida que contém dados de parâmetro de expansão.

[in, optional] Overlapped

Um ponteiro opcional para uma estrutura OVERLAPPED válida se a operação assíncrona for desejada.

Retornar valor

Status da solicitação.

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro. Para obter mais informações, consulte Códigos de erro do sistema.

Comentários

A função ExpandVirtualDisk executa a operação in-loco e, portanto, não cria um disco virtual.

A operação de expansão é válida somente para discos virtuais fixos e expansíveis e invalidará uma cadeia de disco virtual diferente.

Expandir um disco virtual requer que o disco virtual seja desanexado durante a operação.

O chamador deve ter READ|Acesso WRITE ao repositório de backup do disco virtual.

Para um disco virtual expansível, a função ExpandVirtualDisk pode não resultar em um arquivo maior porque o tamanho é virtual e não cresceria fisicamente até ser usado.

Se o disco virtual for expansível e o volume do host não tiver espaço suficiente para o novo tamanho, a função ExpandVirtualDisk poderá ser bem-sucedida de qualquer maneira. As gravações futuras no disco virtual poderão falhar se o volume do host ficar sem espaço à medida que o disco virtual se expande.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho virtdisk.h
Biblioteca VirtDisk.lib
DLL VirtDisk.dll

Confira também

Sobre o VHD

Referência do VHD