Metodo IEnumProgressItems::Next (imapi2fs.h)

Articolo
08/24/2023

Recupera un determinato numero di elementi nella sequenza di enumerazione.

Sintassi

HRESULT Next(
  [in]  ULONG         celt,
  [out] IProgressItem **rgelt,
  [out] ULONG         *pceltFetched
);

Parametri

[in] celt

Numero di elementi da recuperare.

[out] rgelt

Matrice di interfacce IProgressItem . Al termine, è necessario rilasciare ogni interfaccia in rgelt.

[out] pceltFetched

Numero di elementi restituiti in rgelt. È possibile impostare pceltFetched su NULL se celt è uno. In caso contrario, inizializzare il valore di pceltFetched su 0 prima di chiamare questo metodo.

Valore restituito

S_OK viene restituito quando il numero di elementi richiesti (celt) viene restituito correttamente o il numero di elementi restituiti (pceltFetched) è minore del numero di elementi richiesti.

Altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido. Valore: 0x80004003
E_OUTOFMEMORY	Impossibile allocare la memoria richiesta. Valore: 0x8007000E
E_INVALIDARG	Uno o più argomenti non sono validi. Valore: 0x80070057

Commenti

Se nella sequenza sono presenti meno del numero di elementi richiesto, recupera gli elementi rimanenti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2fs.h

Vedi anche

IEnumProgressItems

IEnumProgressItems::RemoteNext

Condividi tramite