Metodo IEnumIDList::Next (shobjidl_core.h)

Articolo
08/26/2023

Recupera il numero specificato di identificatori di elemento nella sequenza di enumerazione e avanza la posizione corrente in base al numero di elementi recuperati.

Sintassi

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

Parametri

[in] celt

Tipo: ULONG

Numero di elementi nella matrice a cui fa riferimento il parametro rgelt .

[out] rgelt

Tipo: LPITEMIDLIST*

Indirizzo di un puntatore a una matrice di puntatori ITEMIDLIST che ricevono gli identificatori dell'elemento. L'implementazione deve allocare questi identificatori di elemento usando CoTaskMemAlloc. L'applicazione chiamante è responsabile della liberazione degli identificatori dell'elemento tramite CoTaskMemFree.

Le strutture ITEMIDLIST restituite nella matrice sono relative all'enumerazione IShellFolder .

[out] pceltFetched

Tipo: ULONG*

Puntatore a un valore che riceve un conteggio degli identificatori di elemento effettivamente restituiti in rgelt. Il conteggio può essere minore del valore specificato nel parametro celt . Questo parametro può essere NULL solo se celt = 1, perché in questo caso il metodo può recuperare solo uno (S_OK) o zero (S_FALSE).

Valore restituito

Tipo: HRESULT

Restituisce S_OK se il metodo ha recuperato correttamente gli elementi di celt richiesti. Questo metodo restituisce solo S_OK se il numero completo di elementi richiesti viene recuperato correttamente.

S_FALSE indica che sono stati richiesti più elementi rispetto a quelli rimasti nell'enumerazione. Il valore a cui punta il parametro pceltFetched specifica il numero effettivo di elementi recuperati. Si noti che il valore sarà 0 se non sono presenti più elementi da recuperare.

Restituisce un valore di errore definito da COM in caso contrario.

Commenti

Se questo metodo restituisce un codice di errore COM (Component Object Model) (come determinato dalla macro FAILED ), non sono valide voci nella matrice rgelt . Se questo metodo restituisce un codice riuscito (ad esempio S_OK o S_FALSE), il parametro ULONG puntato al parametro pceltFetched determina il numero di voci nella matrice rgelt valida all'uscita.

La distinzione è importante nel caso in cui celt> 1. Ad esempio, se si passa celt=10 e sono rimasti solo 3 elementi, *pceltFetched sarà 3 e il metodo restituirà S_FALSE significato che è stato raggiunto la fine del file. I tre elementi recuperati verranno archiviati in rgelt e sono validi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Vedi anche

IEnumIDList

Condividi tramite