Iterating through property and property identifier sets

You construct an iterator using the set appropriate to that iterator. Both TPropertySetIterator and TPropertyIDSetIterator function provide the same functions. Each defines:

• First()

Returns the first property or property identifier in the set. Returns TPropertySetIterator::kEndOfIterator if this set is empty.

• Next()

Returns the next property or property identifier in the set. Returns TPropertySetIterator::kEndOfIterator when the end of this iterator is reached.

This example uses a TPropertySetIterator constructed with a TPropertySet, and iterates through the set, getting the name of each property (via the identifier) and printing it out. This code calls a user-defined function named PrintName which is not defined here.

  TPropertySetIterator iterator(aPropertySet);
  
  for (TProperty property = iterator.First();
      property != TPropertySetIterator::kEndOfIteration;
      property = iterator.Next() )
  {
      TPropertyID identifier = property.GetID();
      identifier.GetName(TPropertyName propName);
      PrintName(propName, " ", "\n");
  }