Função GetVirtualDiskInformation (virtdisk.h)
Recupera informações sobre um VHD (disco rígido virtual).
Sintaxe
DWORD GetVirtualDiskInformation(
[in] HANDLE VirtualDiskHandle,
[in, out] PULONG VirtualDiskInfoSize,
[in, out] PGET_VIRTUAL_DISK_INFO VirtualDiskInfo,
[in, out, optional] PULONG SizeUsed
);
Parâmetros
[in] VirtualDiskHandle
Um identificador para o VHD aberto, que deve ter sido aberto usando o sinalizador VIRTUAL_DISK_ACCESS_GET_INFO definido no parâmetro VirtualDiskAccessMask para a função OpenVirtualDisk . Para obter informações sobre como abrir um VHD, consulte a função OpenVirtualDisk .
[in, out] VirtualDiskInfoSize
Um ponteiro para um ULONG que contém o tamanho do parâmetro VirtualDiskInfo .
[in, out] VirtualDiskInfo
Um ponteiro para uma estrutura de GET_VIRTUAL_DISK_INFO válida. O formato dos dados retornados depende do valor passado no membro Version pelo chamador.
[in, out, optional] SizeUsed
Um ponteiro para um ULONG que contém o tamanho usado.
Valor retornado
Status da solicitação.
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e o parâmetro VirtualDiskInfo conterá as informações solicitadas.
Se a função falhar, o valor retornado será um código de erro e o parâmetro VirtualDiskInfo será indefinido. Para obter mais informações, consulte Códigos de erro do sistema.
Comentários
A função GetVirtualDiskInformation pode ser chamada em qualquer VirtualDiskHandle válido, desde que o identificador tenha sido aberto usando o sinalizador VIRTUAL_DISK_ACCESS_GET_INFO . O VHD não é necessário para ser um disco anexado.
Requisitos
| 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 |