Windows desktop applications
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IIterator<T>::get_HasCurrent method

Gets a value that indicates whether there is a current item or the iterator is at the end of the collection.

Syntax


HRESULT get_HasCurrent(
  [out, retval] boolean *hasCurrent
);

Parameters

hasCurrent [out, retval]

Type: boolean*

TRUE if the iterator refers to a valid item that is in the collection; otherwise, FALSE if the iterator is at the end of the collection.

Return value

Type: HRESULT

This method can return one of these values.

Return codeDescription
S_OK

The current item was retrieved successfully.

E_CHANGED_STATE

The iterator has been invalidated.

 

Remarks

Use the get_HasCurrent method to check for a valid iterator before calling the get_Current method.

Examples

The following code example demonstrates how to use the get_HasCurrent method.


comptr<Folder> spFolder;
hr = GetKnownFolder(FOLDERID_MusicFolder, &spFolder);
//...
comptr<IVectorView<IShellItem2>> spItems;
hr = pFolder->GetItems(&spItems);
//...
comptr<IIterator<IShellItem2>> spIter;
hr = spItems->First(&spIter);
//...
bool hasCurrent;
for (hr = spIter->get_HasCurrent(&hasCurrent); 
     SUCCEEDED(hr) && hasCurrent; 
     hr = spIter->MoveNext(&hasCurrent))
{
    comptr<IShellItem2> spAnItem;
    hr = spIter->get_Current(&spAnItem)
    //...
}


Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

Windows.Foundation.Collections.h

See also

IIterator<T>
IIterable

 

 

Show:
© 2016 Microsoft