Metodo IEnumFullIDList::Next (shobjidl_core.h)

Recupera un numero specificato di elementi IDLIST_ABSOLUTE.

Sintassi

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

Parametri

[in] celt

Tipo: ULONG

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

[out] rgelt

Tipo: PIDLIST_ABSOLUTE*

In caso di esito positivo, contiene una matrice PIDL. L'implementazione deve allocare questi identificatori di elemento usando CoTaskMemAlloc. L'applicazione chiamante è responsabile della liberazione degli identificatori dell'elemento tramite CoTaskMemFree.

[out] pceltFetched

Tipo: ULONG*

In caso di esito positivo, contiene un puntatore a un valore che riceve un conteggio degli identificatori di elemento assoluto 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.

Requisiti