Condividi tramite


Metodo IEnumShellItems::Next (shobjidl_core.h)

Ottiene una matrice di una o più interfacce IShellItem dall'enumerazione .

Sintassi

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

Parametri

[in] celt

Tipo: ULONG

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

[out] rgelt

Tipo: IShellItem**

Indirizzo di una matrice di puntatori alle interfacce IShellItem che ricevono l'elemento o gli elementi enumerati. L'applicazione chiamante è responsabile della liberazione delle interfacce IShellItem chiamando il metodo IUnknown::Release .

[out] pceltFetched

Tipo: ULONG*

Puntatore a un valore che riceve il numero di interfacce IShellItem recuperate correttamente. Il conteggio può essere inferiore al valore specificato nel parametro celt . Questo parametro può essere NULL solo se celt è uno, perché in tal caso il metodo può recuperare un solo elemento e restituire S_OK oppure zero elementi e restituire S_FALSE.

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
se è stata recuperata almeno l'interfaccia IShellItem .
S_FALSE
se nell'enumerazione non sono presenti altre interfacce IShellItem .
Restituisce un valore di errore se la funzione ha esito negativo per qualsiasi altro motivo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)

Vedi anche

IEnumShellItems

IShellItem