Método IVdsHwProviderStoragePools::QueryStoragePools (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 un objeto de enumeración IEnumVdsObject que contiene una lista de los grupos de almacenamiento administrados por el proveedor de hardware.

Sintaxis

HRESULT QueryStoragePools(
  [in]  ULONG               ulFlags,
  [in]  ULONGLONG           ullRemainingFreeSpace,
  [in]  VDS_POOL_ATTRIBUTES *pPoolAttributes,
  [out] IEnumVdsObject      **ppEnum
);

Parámetros

[in] ulFlags

Máscara de bits de una o varias marcas de VDS_STORAGE_POOL_TYPE que especifican los tipos de grupos de almacenamiento que se van a consultar. Una de las marcas debe ser VDS_SPT_CONCRETE o VDS_SPT_PRIMORDIAL. El valor predeterminado de este parámetro es cero. Un valor de cero significa que se deben consultar todos los grupos de almacenamiento.

[in] ullRemainingFreeSpace

Cantidad mínima de espacio libre, en bytes, que debe contener cada bloque de almacenamiento. El valor predeterminado de este parámetro es cero. Un valor de cero significa que los grupos de almacenamiento pueden contener cualquier cantidad de espacio libre.

[in] pPoolAttributes

Puntero a una estructura VDS_POOL_ATTRIBUTES que especifica los valores de atributo que deben tener los grupos de almacenamiento devueltos. El valor predeterminado de este parámetro es NULL. Un valor null significa que los grupos de almacenamiento pueden tener cualquier valor de atributo.

[out] ppEnum

Dirección de un puntero de interfaz IEnumVdsObject que se puede usar para enumerar los grupos de almacenamiento. Para obtener más información, vea Trabajar con objetos de enumeración. Los autores de llamadas deben liberar la interfaz y cada uno de los objetos del bloque de almacenamiento cuando ya no sean necesarios mediante una llamada al método IUnknown::Release . Este parámetro es obligatorio y no puede ser NULL.

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 devuelto	Descripción
S_OK	El método se completó correctamente.

Comentarios

Si el proveedor de hardware no administra ningún grupo de almacenamiento, este método devuelve un objeto de enumeración vacío.

Si se especifica un valor distinto de NULL en el parámetro pPoolAttributes , este método devuelve solo los grupos de almacenamiento que satisfacen todos los atributos especificados en la estructura VDS_POOL_ATTRIBUTES . Si se especifican atributos mínimos y máximos, los grupos de almacenamiento que se devuelven deben coincidir exactamente con estos atributos. Los atributos de sugerencia se usan como sugerencias para filtrar aún más los grupos de almacenamiento que satisfacen todos los atributos especificados. Si un atributo especificado no se aplica a ninguno de los grupos de almacenamiento, este método devuelve S_OK con un objeto de enumeración vacío.

Requisitos

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

Consulte también

IVdsHwProviderStoragePools