Método IMDSPEnumStorage::Next (mswmdm.h)

Artículo
02/29/2024

El método Next devuelve un puntero a las siguientes interfaces DE IMDSPStoragecelt.

Sintaxis

HRESULT Next(
  [in]  ULONG        celt,
  [out] IMDSPStorage **ppStorage,
  [out] ULONG        *pceltFetched
);

Parámetros

[in] celt

Número de interfaces de almacenamiento solicitadas.

[out] ppStorage

Matriz de punteros de interfaz celt IMDSPStorage asignados por el autor de la llamada. Devuelve NULL si no existen más medios de almacenamiento o se ha producido un error. Si celt es mayor que 1, el autor de la llamada debe asignar suficiente memoria para almacenar el número celt de punteros de interfaz.

[out] pceltFetched

Puntero a una variable ULONG que recibe el recuento de interfaces devueltas.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Cuando no hay más interfaces de almacenamiento o cuando hay menos interfaces de almacenamiento de las solicitadas, el valor devuelto de Next es S_FALSE. Cuando esto sucede, se debe consultar el parámetro pceltFetched para determinar cuántas interfaces, si existen, se devolvieron.

Es posible que el enumerador de almacenamiento no refleje el efecto de la inserción y eliminación de medios. En tales casos, el cliente debe obtener un nuevo objeto enumerador.

Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.