 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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 CoCreateInstancefunction, 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 IUnknowninterface.
| 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 |