REQUIRED_CATEGORY

REQUIRED_CATEGORY( catID )

Parameters

catID

The ID of the required category. A globally unique identifier (GUID). The list below shows a sample of the stock categories.

Ability Category CatID (GUID)
Simple Frame Site Containment CATID_SimpleFrameControl [in] {157083E0-2368-11cf-87B9-00AA006C8166}
Simple Data Binding CATID_PropertyNotifyControl [in] {157083E1-2368-11cf-87B9-00AA006C8166}
Advanced Data Binding CATID_VBDataBound [in] {157083E2-2368-11cf-87B9-00AA006C8166}
Windowless Controls CATID_WindowlessObject [in] {1D06B600-3AE3-11cf-87B9-00AA006C8166}
Internet-Aware Objects See Internet Aware Objects in the Platform SDK for a sample list.

Remarks

A category that the COM object requires of its container.

When a user installs a COM object, it registers itself as a control in the system registry using its component category ID. This ID identifies the control's abilities and requirements. For example, the COM object may require that a container support data binding. If the container does not support the required feature, the container can refuse to host the COM object.

For more information about component categories, including a sample list, see What are Component Categories and how do they work? in the Platform SDK.

Example

See SERVICE_ENTRY

ATL Macros and Global Functions

See Also

BEGIN_CATEGORY_MAP, IMPLEMENTED_CATEGORY, END_CATEGORY_MAP