Share via


REQUIRED_CATEGORY

REQUIRED_CATEGORY 巨集加入至元件的 類別對應 指定應將其註冊為要求 catID 參數所識別的分類。

REQUIRED_CATEGORY( 
   catID  
)

參數

  • catID
    [out] 用來存放必要分類的 CATID 常數或變數的全域唯一識別項 (Locale Identifier (GUID)。 catID 位址要採取並加入至對應。 為內建型別的選取請參閱下表。

備註

在對應中的元件分類會自動註冊,則模組註冊,如果類別有關聯的 OBJECT_ENTRY_AUTOOBJECT_ENTRY_NON_CREATEABLE_EX_AUTO 巨集。

用戶端可以使用的分類資訊以類別就可以判斷其功能和需求,而不需要建立它的執行個體。 例如,控制項可能需要容器支援資料繫結。 容器可以找到,則具有必要的功能可以透過查詢該控制項所需要之分類的類別處理常式裝載控制項。 如果容器不支援必要功能,因此可以拒絕裝載 COM 物件。

如需元件類別的詳細資訊,包括範例的清單,請參閱 Windows SDK什麼是如何元件分類和其工作?

內建型別的選取範圍。

描述

符號

註冊 GUID

指令碼的安全

CATID_SafeForScripting

7DD95801-9882-11CF-9FA9-00AA006 C42 C4 {}

初始化的安全

CATID_SafeForInitializing

7DD95802-9882-11CF-9FA9-00AA006 C42 C4 {}

簡單的架構網站內含項目

CATID_SimpleFrameControl

157083E0-2368-11cf-87B9-00AA006 C8166 {}

簡單資料繫結

CATID_PropertyNotifyControl

157083E1-2368-11cf-87B9-00AA006 C8166 {}

進階資料繫結

CATID_VBDataBound

157083E2-2368-11cf-87B9-00AA006 C8166 {}

無視窗控制項

CATID_WindowlessObject

1D06B600-3AE3-11cf-87B9-00AA006 C8166 {}

網際網路感知物件

如需範例清單中看到在 Windows SDK 的 網際網路感知物件

 

範例

BEGIN_CATEGORY_MAP(CMyWindow)
   REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()

需求

Header: atlcom.h

請參閱

參考

BEGIN_CATEGORY_MAP

IMPLEMENTED_CATEGORY

END_CATEGORY_MAP

其他資源

Category Macros

ATL 巨集