Método IEnumOleUndoUnits::Next (ocidl.h)

  • Artículo

Recupera el número especificado de elementos de la secuencia de enumeración.

Sintaxis

HRESULT Next(
  [in]  ULONG        cElt,
  [out] IOleUndoUnit **rgElt,
  [out] ULONG        *pcEltFetched
);

Parámetros

[in] cElt

Número de elementos que se van a recuperar. Si hay menos elementos que el número solicitado de elementos que quedan en la secuencia, este método recupera los elementos restantes.

[out] rgElt

Matriz de elementos enumerados.

El enumerador es responsable de llamar a AddRef y el autor de la llamada es responsable de llamar a Release a través de cada puntero enumerado. Si cElt es mayor que 1, el autor de la llamada también debe pasar un puntero no NULL pasado a pcEltFetched para saber cuántos punteros liberar.

[out] pcEltFetched

Número de elementos recuperados. Este parámetro siempre es menor o igual que el número de elementos solicitados.

Valor devuelto

Si el método recupera el número de elementos solicitados, el valor devuelto se S_OK. De lo contrario, es S_FALSE.

Comentarios

El autor de la llamada es responsable de llamar al método Release para cada elemento de la matriz una vez que este método se devuelve correctamente. Si cUndoUnits es mayor que uno, el autor de la llamada también debe pasar un puntero distinto de NULL a pcFetched para obtener el número de punteros que tiene que liberar.

E_NOTIMPL no se permite como valor devuelto. Si se devuelve un valor de error, no hay entradas en la matriz rgpcd válidas al salir y no requieren ninguna versión.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IEnumOleUndoUnits

IOleUndoUnit