Compartir a través de


Método IVdsLunPlex::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 una matriz de las extensiones de unidad que contribuyen al plex.

Sintaxis

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

Parámetros

[out] ppExtentArray

Puntero a la matriz de punteros para impulsar las extensiones pasadas por el autor de la llamada. Estas son las extensiones que contribuyen al plex. Consulte la estructura VDS_DRIVE_EXTENT . Los autores de llamadas deben liberar esta matriz mediante la función CoTaskMemFree .

[out] plNumberOfExtents

Puntero al número de extensiones de unidad devueltas en ppExtentArray.

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 se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código o valor devuelto Descripción
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Este valor devuelto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre la matriz. Use el método IVdsHwProvider::Reenumerate seguido del método IVdsHwProvider::Refresh para restaurar la memoria caché.
VDS_E_OBJECT_DELETED
0x8004240BL
El plex LUN ya no está presente.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
El plex lun está en estado de error y no puede realizar la operación solicitada.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
Otra operación está en curso; esta operación no puede continuar hasta que se completen las operaciones o operaciones anteriores.

Comentarios

Use el método IVdsDrive::QueryExtents para obtener las extensiones de una unidad determinada.

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

Consulte también

IVdsDrive::QueryExtents

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLunPlex

VDS_DRIVE_EXTENT