IEnumIDListNext Method

[PreserveSigAttribute]
HResult Next(
	uint count,
	ref IntPtr refPidls,
	ref uint refFetched
)

<PreserveSigAttribute>
Function Next ( 
	count As UInteger,
	ByRef refPidls As IntPtr,
	ByRef refFetched As UInteger
) As HResult

Dim instance As IEnumIDList
Dim count As UInteger
Dim refPidls As IntPtr
Dim refFetched As UInteger

Dim returnValue As HResult

returnValue = instance.Next(count, refPidls, 
	refFetched)

[PreserveSigAttribute]
HResult Next(
	unsigned int count, 
	IntPtr% refPidls, 
	unsigned int% refFetched
)

[<PreserveSigAttribute>]
abstract Next : 
        count : uint32 * 
        refPidls : IntPtr byref * 
        refFetched : uint32 byref -> HResult 

No code example is currently available or this language may not be supported.

Parameters

count  UInt32

The number of elements in the array referenced by the rgelt parameter.

refPidls  IntPtr

The address of a pointer to an array of ITEMIDLIST pointers that receive the item identifiers.

The implementation must allocate these item identifiers using CoTaskMemAlloc.

The calling application is responsible for freeing the item identifiers using CoTaskMemFree.

refFetched  UInt32

A pointer to a value that receives a count of the item identifiers actually returned in refPidls.

The count can be smaller than the value specified in the count parameter.

This parameter can be NULL on entry only if count = 1, because in that case the method can only retrieve one (S_OK) or zero (S_FALSE) items.

Return Value

This method only returns S_OK if the full count of requested items are successfully retrieved.

S_FALSE indicates that more items were requested than remained in the enumeration.

The value pointed to by the refPidls parameter specifies the actual number of items retrieved. Note that the value will be 0 if there are no more items to retrieve.

Reference