Método IVdsDisk::QueryExtents (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Devuelve los detalles de todas las extensiones de un disco.

Sintaxis

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

Parámetros

[out] ppExtentArray

Variable de puntero que recibe un
matriz de estructuras de VDS_DISK_EXTENT . Los autores de llamadas deben liberar esta matriz mediante la función CoTaskMemFree .

[out] plNumberOfExtents

Dirección de un tipo LONG que representa el número total de extensiones.

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Comentarios

Use este método para determinar la cantidad de espacio libre disponible para crear o extender volúmenes. También puede usar la información de extensión para determinar cuántos volúmenes ocupan el disco. Los tipos de extensión válidos son: extensiones desconocidas, extensiones libres, extensiones de datos, extensiones oem, extensiones ESP, extensiones msr, extensiones de metadatos LDM y extensiones inutilizables. Una extensión de datos contiene un vínculo al volumen sobre él.

Si el disco es un disco dinámico, debe estar en línea. Si es un disco básico o un disco sin procesar, puede estar en línea o sin conexión.

Requisitos

Consulte también

IVdsDisk

IVdsDisk::ClearFlags

IVdsDisk::ConvertStyle

IVdsDisk::GetIdentificationData

IVdsDisk::GetPack

IVdsDisk::GetProperties

IVdsDisk::SetFlags

VDS_DISK_EXTENT