Método IEnumShellItems::Next (shobjidl_core.h)
Obtém uma matriz de uma ou mais interfaces IShellItem da enumeração .
Sintaxe
HRESULT Next(
[in] ULONG celt,
[out] IShellItem **rgelt,
[out] ULONG *pceltFetched
);
Parâmetros
[in] celt
Tipo: ULONG
O número de elementos na matriz referenciada pelo parâmetro rgelt .
[out] rgelt
Tipo: IShellItem**
O endereço de uma matriz de ponteiros para interfaces IShellItem que recebem o item ou itens enumerados. O aplicativo de chamada é responsável por liberar as interfaces IShellItem chamando o método IUnknown::Release .
[out] pceltFetched
Tipo: ULONG*
Um ponteiro para um valor que recebe o número de interfaces IShellItem recuperadas com êxito. A contagem pode ser menor que o valor especificado no parâmetro celt . Esse parâmetro só poderá ser NULL na entrada se celt for um, pois nesse caso o método só poderá recuperar um item e retornar S_OK ou zero itens e retornar S_FALSE.
Retornar valor
Tipo: HRESULT
Esse método pode retornar um desses valores.
Código de retorno | Descrição |
---|---|
|
se pelo menos a interface IShellItem foi recuperada. |
|
se não houver mais interfaces IShellItem na enumeração . |
Retorna um valor de erro se a função falhar por qualquer outro motivo. |
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |