Registrando a extensão de criação de objeto

Quando uma DLL de extensão de criação de objeto nos Serviços de Domínio Active Directory é criada, ela deve ser registrada no Registro do Windows e nos Serviços de Domínio Active Directory para que os snap-ins do MMC administrativo do COM e do Active Directory reconheçam a extensão.

Registrando-se no Registro do Windows

Como todos os servidores COM, uma extensão de criação de objeto deve ser registrada no registro do Windows. A extensão é registrada sob a seguinte chave:

HKEY_CLASSES_ROOT
   CLSID
      <extension CLSID>
         InProcServer32
            (Default) = <extension path>
            ThreadingModel = Apartment

"<extensão CLSID>" é a representação de cadeia de caracteres do CLSID como produzido pela função StringFromCLSID . "<caminho> de extensão" contém o caminho e o nome do arquivo da DLL de extensão. O valor ThreadingModel para todas as extensões de criação de objeto deve ser "Apartment".

Registrando-se nos Serviços de Domínio Active Directory

O registro da extensão de criação de objeto é específico para uma localidade. Se a extensão de criação de objeto se aplicar a todas as localidades, ela deverá ser registrada no objeto displaySpecifier da classe de objeto em todos os subcontêineres de localidade no contêiner DisplaySpecifiers. Se a extensão de criação de objeto estiver localizada para uma determinada localidade, registre-a no objeto displaySpecifier no subcontêiner dessa localidade. Para obter mais informações sobre o contêiner DisplaySpecifiers e localidades, consulte Display Specifiers e DisplaySpecifiers Container.

Há dois atributos DisplaySpecifier nos quais uma extensão de criação de objeto pode ser registrada. Estes são creationWizard e createWizardExt.

O atributo creationWizard identifica extensões de criação de objeto primário para substituir o assistente de criação de objeto nativo ou existente nos snap-ins administrativos do Active Directory. Uma extensão de criação primária fornece o primeiro conjunto de páginas e é hospedada da mesma forma que as páginas nativas. Esse atributo tem valor único e requer o seguinte formato:

<CLSID>

O "CLSID"< é a representação de cadeia de caracteres do CLSID do objeto COM, conforme produzido pela função StringFromCLSID.>

O atributo createWizardExt identifica extensões de criação de objeto secundário. Uma extensão de criação secundária adiciona páginas do assistente às páginas nativas ou à extensão primária. Esse atributo tem vários valores e requer o seguinte formato:

<order number>,<CLSID>

O "número do pedido"< é um número> não assinado que representa a posição da página no assistente. Quando um assistente de criação é exibido, os valores são classificados usando uma comparação do "<número> do pedido" de cada valor. Se mais de um valor tiver o mesmo "<número> do pedido", essas páginas serão carregadas na ordem em que forem lidas no servidor do Active Directory. Se possível, você deve usar um "número> de pedido"< não existente (ou seja, que não tenha sido usado por outros valores na propriedade). Não há uma posição inicial prescrita, e lacunas são permitidas na sequência "<número> de ordem".

O "CLSID"< é a representação de cadeia de caracteres do CLSID do objeto COM, conforme produzido pela função StringFromCLSID.>