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 |
---|---|
|
se è stata recuperata almeno l'interfaccia IShellItem . |
|
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) |