Compartir a través de

Método IEnumVdsObject::Next (vds.h)

  • Artículo

[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 número especificado de objetos de la enumeración, comenzando desde el punto actual. Para obtener más información, vea Trabajar con objetos de enumeración.

Sintaxis

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

Parámetros

[in] celt

Número de objetos que se van a devolver.

[out] ppObjectArray

Dirección de una matriz de punteros IUnknown , que VDS inicializa al devolver.

[out] pcFetched

La dirección de un ULONG, que VDS inicializa al volver al número de objetos de ppObjectArray.

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 devolvió el número especificado de objetos. El número de objetos devueltos notificados en pcFetched es igual a celt; devuelve esos objetos.
S_FALSE
 El número especificado de objetos devueltos es mayor que el número de objetos restantes. Se devuelven todos los objetos restantes y el número de objetos devueltos se notifica en pcFetched es menor que celt; devuelve esos objetos.

Comentarios

Para obtener punteros de interfaz específicos del objeto de los punteros IUnknown devueltos en la matriz ppObjectArray , use el método IUnknown::QueryInterface .

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

IEnumVdsObject