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

Confira também

Sobre o VHD

GET_VIRTUAL_DISK_INFO

Referência de VHD