Assistentes de Criação de Objetos

Nos snap-ins administrativos do MMC dos Serviços de Domínio Active Directory, o usuário pode criar novos objetos em um diretório abrindo o menu de contexto do contêiner onde o novo objeto será criado, escolhendo Novo e escolhendo a classe de objeto a ser criada. A criação de novas instâncias de um objeto inicia o assistente de criação de objeto. Cada classe de objeto pode especificar o uso de um assistente de criação específico ou pode usar um assistente de criação genérico. Para classes comuns, como user e organizationalUnit, o snap-in Usuários e Computadores do Active Directory fornece um conjunto padrão de assistentes de criação.

Há duas maneiras de estender um assistente de criação:

• Substitua um assistente existente ou forneça um se não existir um para a classe: O assistente existente é substituído pela criação de uma extensão de criação de objeto primário. 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. Uma extensão de criação primária também oferece suporte ao mecanismo de extensibilidade para que outras extensões do assistente de criação possam ser invocadas. Para obter um exemplo de uma extensão primária, consulte o exemplo scpwizard no Platform Software Development Kit (SDK).
• Estender um assistente existente: um assistente existente pode ser estendido com uma extensão 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. Para obter mais informações e um exemplo de uma extensão de criação secundária, consulte o exemplo userwizard no Platform SDK.

Público-alvo do desenvolvedor

Esta documentação pressupõe que o leitor esteja familiarizado com a operação COM e o desenvolvimento de componentes usando C++. No momento, não é possível criar uma extensão para o assistente de criação de objeto do Active Directory usando o Visual Basic.

Criando uma extensão de criação de objeto do Active Directory

As extensões de criação de objetos primário e secundário são servidores COM in-proc que implementam determinadas interfaces e são registrados nos Serviços de Domínio Active Directory.

Para criar e instalar uma extensão de criação de objeto

1. Crie a DLL de extensão de criação de objeto. Uma extensão de criação de objeto é um servidor COM in-proc que, no mínimo, implementa a interface IDsAdminNewObjExt. Para obter mais informações, consulte Implementando o objeto COM de extensão de criação de objeto.
2. Instale a extensão de criação em computadores onde a extensão de criação deve ser usada. Para fazer isso, crie um pacote do Microsoft Windows Installer para a DLL de extensão de criação e implante o pacote adequadamente usando a diretiva de grupo. Para obter mais informações, consulte Distribuindo componentes da interface do usuário.
3. Registre a extensão de criação no Registro do Windows e com os Serviços de Domínio Active Directory. Para obter mais informações, consulte Registrando a extensão de criação de objeto.

Usando um Assistente de Criação de Objeto

Um assistente de criação de objeto também pode ser chamado de um aplicativo diferente dos snap-ins administrativos do MMC dos Serviços de Domínio Active Directory. Para obter mais informações, consulte Invocando assistentes de criação de seu aplicativo.

Se um assistente de criação não estiver registrado para uma classe de objeto, os snap-ins administrativos fornecerão um assistente de criação genérico. O assistente de criação genérica é criado em tempo de execução a partir da lista de propriedades obrigatórias para a classe de objeto criado. Para cada propriedade obrigatória, uma página é adicionada à interface do usuário. O assistente de criação genérica não é extensível. Se a extensibilidade for necessária, ela deverá ser substituída por uma extensão de criação de objeto primário.