Compartilhar via


Método IDsAdminNewObjExt::Initialize (dsadmin.h)

O método IDsAdminNewObjExt::Initialize inicializa uma extensão do assistente de criação de objeto.

Sintaxe

HRESULT Initialize(
  [in] IADsContainer         *pADsContainerObj,
  [in] IADs                  *pADsCopySource,
  [in] LPCWSTR               lpszClassName,
  [in] IDsAdminNewObj        *pDsAdminNewObj,
  [in] LPDSA_NEWOBJ_DISPINFO pDispInfo
);

Parâmetros

[in] pADsContainerObj

Ponteiro para a interface IADsContainer de um contêiner existente em que o objeto é criado. Esse parâmetro não deve ser NULL. Se esse objeto deve ser mantido além do escopo desse método, a contagem de referência deve ser incrementada chamando IUnknown::AddRef ou IUnknown::QueryInterface.

[in] pADsCopySource

Ponteiro para a interface IADs do objeto do qual uma cópia é feita. Se o novo objeto não for copiado de outro objeto, esse parâmetro será NULL. Para obter mais informações sobre operações de cópia, consulte a seção Comentários. Se esse objeto deve ser mantido além do escopo desse método, a contagem de referência deve ser incrementada chamando IUnknown::AddRef ou IUnknown::QueryInterface.

[in] lpszClassName

Ponteiro para uma cadeia de caracteres WCHAR que contém o nome LDAP da classe de objeto a ser criada. Esse parâmetro não deve ser NULL. Os valores com suporte são: "user", "computer", "printQueue", "group" e "contact".

[in] pDsAdminNewObj

Ponteiro para uma interface IDsAdminNewObj que contém dados adicionais sobre o assistente. Você também pode obter a interface IDsAdminNewObjPrimarySite da extensão primária chamando QueryInterface com IID_IDsAdminNewObjPrimarySite nessa interface. Se esse objeto deve ser mantido além do escopo desse método, a contagem de referência deve ser incrementada chamando IUnknown::AddRef ou IUnknown::QueryInterface.

[in] pDispInfo

Ponteiro para uma estrutura DSA_NEWOBJ_DISPINFO que contém dados adicionais sobre o assistente de criação de objeto.

Valor retornado

Retorna S_OK se tiver êxito ou um código de erro definido por OLE caso contrário.

Comentários

Um objeto no Active Directory Domain Services pode ser criado a partir de nada ou copiado de um objeto existente. Se o novo objeto for criado a partir de um objeto existente, pADsCopySource conterá um ponteiro para o objeto do qual a cópia é feita. Se o novo objeto não estiver sendo copiado de outro objeto, pADsCopySource será NULL. A operação de cópia só tem suporte para objetos de usuário.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho dsadmin.h
DLL DSAdmin.dll

Confira também

DSA_NEWOBJ_DISPINFO

Iads

IADsContainer

IDsAdminNewObj

IDsAdminNewObjExt

IDsAdminNewObjPrimarySite

IUnknown::AddRef

IUnknown::QueryInterface