ISharedPropertyGroupManager::get__NewEnum Method

[This product will work only on Windows NT 4.0 versions and earlier. For Windows 2000 and later, see COM+ (Component Services).]

Returns a reference to an enumerator that you can use to iterate through all the shared property groups in a process.

Provided By

ISharedPropertyGroupManager Interface

HRESULT ISharedPropertyGroupManager::get__NewEnum (
    IUnknown** ppEnumerator
);

Parameters

ppEnumerator
[out] A reference to the IUnknown interface on a new enumerator object that you can use to iterate through the list of all the shared property groups in the process.

Return Values

S_OK
A reference to the requested enumerator is returned in the ppEnumerator parameter.

Remarks

You use the get__NewEnum method to obtain a reference to an enumerator object. You should immediately call QueryInterface on the returned IUnknown for the IEnumVARIANT interface. This interface exposes several methods you can use to iterate through a list of BSTRs representing shared property group names. Once you have a name, you can use the get_Group method to obtain a reference to the shared property group it represents.

As with any COM object, you must release an enumerator object when you're finished using it. When you enumerate the shared property groups, all groups will be included. However, if you then call CreatePropertyGroup to add a new group, the existing enumerator won't include the new group even if you call Reset or Clone. To include the new group, you must create a new enumerator by calling get__NewEnum again.

Note get__NewEnum has two underscore characters between get and NewEnum.

Example

See Also

ISharedPropertyGroupManager::get_Group Method, ISharedPropertyGroup Interface