TRefPointerCollection Class

[The TRefPointerCollection class is part of the WMI Provider Framework which is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]

The TRefPointerCollection class is a container class that collects pointers to objects. These pointers can be enumerated.

TRefPointerCollection has these types of members:

Methods

The TRefPointerCollection class has these methods.
Method Description
Add Adds an item to a collection and calls the AddRef method to increment the reference count.
BeginEnum Begins an enumeration of a collection. Call this method with the cursor to be initialized as a parameter before enumerating the collection (REFPTRCOLLECTION_POSITION).
Empty Empties out the list, releasing all held pointers.
EndEnum Ends enumeration of a collection. Call this method when the enumerating operation is finished.
GetNext Gets next item from the list and calls the AddRef method to increment the reference count. (The user must release the pointer when done and pass in the same cursor each time.)
GetSize Returns the number of items in the list.
TRefPointerCollection Constructs a new TRefPointerCollection object.

Methods

The TRefPointerCollection class has these methods.

Method Description
TRefPointerCollection::Add The Add method adds a reference to the collection.
TRefPointerCollection::BeginEnum The BeginEnum method starts enumerating the collection.
TRefPointerCollection::Empty The Empty method removes all items from the collection.
TRefPointerCollection::EndEnum The EndEnum method ends the enumeration of the collection.
TRefPointerCollection::GetNext The GetNext method gets a pointer to the next instance in the collection.
TRefPointerCollection::GetSize The GetSize method returns how many items are in the list.
TRefPointerCollection::TRefPointerCollection This constructor initializes a new TRefPointerCollection object.
TRefPointerCollection::TRefPointerCollection This constructor initializes a new TRefPointerCollection object.

Remarks

The destructor for this class is TRefPointerCollection::~TRefPointerCollection.

Requirements

   
Windows version Windows Vista Windows Server 2008
Target Platform Windows
Header refptrco.h (include FwCommon.h)