ICatRegister
A version of this page is also available for
4/8/2010
This interface provides methods for registering and unregistering component category information in the Registry.
This includes both the human-readable names of categories and the categories implemented/required by a given component or class.
When to Implement
There is no need to implement this interface. The Component Category Manager, a system-provided COM object that can be instantiated by using the CoCreateInstance function, implements ICatRegister.
When to Use
The owner of a category uses this interface to register or unregister the human-readable names. The owner of a component uses this interface to add or remove categories implemented or required by this component.
Methods
The following table shows the methods for this interface in the order that the compiler calls the methods. Like all COM interfaces, this interface inherits the methods for the IUnknown interface.
| IUnknown method | Description |
|---|---|
Returns pointers to supported interfaces. |
|
Increments reference count. |
|
Decrements reference count. |
| ICatRegister method | Description |
|---|---|
Registers one or more component categories. |
|
Removes the registration of one or more component categories. |
|
Registers the class as implementing one or more component categories. |
|
Removes one or more implemented category identifiers from a class. |
|
Registers the class as requiring one or more component categories. |
|
Removes one or more required category identifiers from a class. |
Remarks
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
| Header | comcat.h, comcat.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |