Assistentes de Criação de Objeto

Nos snap-ins administrativos do MMC do Active Directory Domain Services, o usuário pode criar novos objetos em um diretório abrindo o menu de contexto para o contêiner em que o novo objeto será criado, escolhendo Novoe 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 usuário 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 caso não exista 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 dá 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 SDK (Platform Software Development Kit).
• Estender um assistente existente: um assistente existente pode ser estendido com uma extensão de criação de objeto secundária. Uma extensão de criação secundária adiciona páginas de 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 SDK da Plataforma.

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 objetos 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 objeto primário e secundário são servidores COM in-proc que implementam determinadas interfaces e são registrados no Active Directory Domain Services.

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 interfaceIDsAdminNewObjExt. Para obter mais informações, consulte Implementando o objeto COM da extensão de criação de objeto.
2. Instale a extensão de criação em computadores em que 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 política de grupo. Para obter mais informações, consulte distribuição de componentes de interface do usuário.
3. Registre a extensão de criação no Registro do Windows e com o Active Directory Domain Services. 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 invocado de um aplicativo diferente dos snap-ins administrativos do MMC do Active Directory Domain Services. 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 criada. 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.