Compartir a través de


Función GetVirtualDiskInformation (virtdisk.h)

Recupera información sobre un disco duro virtual (VHD).

Sintaxis

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

Identificador del VHD abierto, que debe haberse abierto con la marca VIRTUAL_DISK_ACCESS_GET_INFO establecida en el parámetro VirtualDiskAccessMask en la función OpenVirtualDisk . Para obtener información sobre cómo abrir un disco duro virtual, consulte la función OpenVirtualDisk .

[in, out] VirtualDiskInfoSize

Puntero a un ULONG que contiene el tamaño del parámetro VirtualDiskInfo .

[in, out] VirtualDiskInfo

Puntero a una estructura de GET_VIRTUAL_DISK_INFO válida. El formato de los datos devueltos depende del valor pasado en el miembro Version por el autor de la llamada.

[in, out, optional] SizeUsed

Puntero a un ULONG que contiene el tamaño utilizado.

Valor devuelto

Estado de la solicitud.

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS y el parámetro VirtualDiskInfo contiene la información solicitada.

Si se produce un error en la función, el valor devuelto es un código de error y el parámetro VirtualDiskInfo no está definido. Para obtener más información, vea Códigos de error del sistema.

Comentarios

Se puede llamar a la función GetVirtualDiskInformation en cualquier VirtualDiskHandle válido, siempre que se abra el identificador con la marca VIRTUAL_DISK_ACCESS_GET_INFO . No es necesario que el disco duro virtual sea un disco conectado.

Requisitos

   
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Plataforma de destino Windows
Encabezado virtdisk.h
Library VirtDisk.lib
Archivo DLL VirtDisk.dll

Consulte también

Acerca de VHD

GET_VIRTUAL_DISK_INFO

Referencia de VHD