Função ExpandVirtualDisk (virtdisk.h)
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 |