Compartilhar via


REQUIRED_CATEGORY

Adicionar um REQUIRED_CATEGORY macro para seu componente MAP de categoria para especificar que deve ser registrado sistema autônomo exigindo a categoria identificada pelo catID parâmetro.

REQUIRED_CATEGORY( 
      catID  
)

Parâmetros

  • catID
    [in] A CATID constante ou variável que contém o identificador global exclusivo (GUID) para a categoria necessária.O endereço de catID será executada e adicionado ao MAP. Consulte a tabela a seguir para uma seleção das categorias das ações.

Comentários

Componente categorias listadas no MAP serão registradas automaticamente quando o módulo é registrado, se a classe tem um associado OBJECT_ENTRY_AUTO or OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO macro.

Os clientes podem usar as informações de categoria registrado para a classe para determinar seus recursos e requisitos sem ter que criar uma instância dele.Por exemplo, um controle pode exigir que um contêiner suporta a vinculação de dados.O contêiner pode descobrir se ele tem os recursos necessários para host controle consultando o gerente de categoria referentes às categorias necessários para que o controle.Se o contêiner não oferecer suporte a um recurso obrigatório, ele pode se recusar a hospedar o objeto COM.

Para obter mais informações sobre categorias de componente, incluindo um exemplo de lista, consulte O que são categorias de componentes e como eles funcionam? in the Windows SDK.

Uma seleção de categorias de ações

Descrição

Símbolo

GUID de registro

Seguro para scripts

CATID_SafeForScripting

{7DD95801-9882-11CF-9FA9-00AA006C42C4}

Seguro para inicialização

CATID_SafeForInitializing

{7DD95802-9882-11CF-9FA9-00AA006C42C4}

Contenção de site quadro simples

CATID_SimpleFrameControl

{157083E0-2368-11cf-87B9-00AA006C8166}

vinculação de dados simples

CATID_PropertyNotifyControl

{157083E1-2368-11cf-87B9-00AA006C8166}

vinculação de dados avançada

CATID_VBDataBound

{157083E2-2368-11cf-87B9-00AA006C8166}

Controles sem janelas

CATID_WindowlessObject

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

Objetos compatíveis com a Internet

See Objetos com reconhecimento de Internet in the Windows SDK Para obter uma lista de amostra.

 

Exemplo

BEGIN_CATEGORY_MAP(CMyWindow)
   REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()

Anotações Developer Dispositivo Inteligente

Não tem suporte para projetos de dispositivo SMART.

Requisitos

Cabeçalho: atlcom.h

Consulte também

Referência

BEGIN_CATEGORY_MAP

IMPLEMENTED_CATEGORY

END_CATEGORY_MAP

Outros recursos

Macros de categoria

Macros ATL