IItemMetadataEnumerator::Next

Returns the next metadata items in the list, if available.

HRESULT Next( 
  ULONG cItems, 
  IItemMetadata ** ppItemMetadata, 
  ULONG *pcFetched);

Parameters

  • cItems
    [in, range(0, 1)] The number of metadata items to retrieve. Must be 1.
  • ppItemMetadata
    [out, size_is(cItems), length_is(*pcFetched)] Returns the next cItems metadata items.
  • pcFetched
    [out] Returns the number of metadata items that were retrieved. This value can be NULL.

Return Value

  • S_OK.

  • S_FALSE is there are no more items to enumerate.

  • E_POINTER.

  • E_INVALIDARG when cItems is not 1.

See Also

Reference

IItemMetadataEnumerator Interface