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

Artículo
03/03/2024

[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.

Código o valor devuelto	Descripción
S_OK	La información de extensión se devolvió correctamente.
VDS_E_PACK_OFFLINE 0x80042444L	El paquete al que pertenece el disco es inaccesible.

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

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vds.h
Library	Uuid.lib