Método IDsAdminNewObjExt::Initialize (dsadmin.h)
El método IDsAdminNewObjExt::Initialize inicializa una extensión del asistente para la creación de objetos.
Sintaxis
HRESULT Initialize(
[in] IADsContainer *pADsContainerObj,
[in] IADs *pADsCopySource,
[in] LPCWSTR lpszClassName,
[in] IDsAdminNewObj *pDsAdminNewObj,
[in] LPDSA_NEWOBJ_DISPINFO pDispInfo
);
Parámetros
[in] pADsContainerObj
Puntero a la interfaz IADsContainer de un contenedor existente donde se crea el objeto. Este parámetro no debe ser NULL. Si este objeto se va a mantener más allá del ámbito de este método, el recuento de referencias debe incrementarse llamando a IUnknown::AddRef o IUnknown::QueryInterface.
[in] pADsCopySource
Puntero a la interfaz iaDs del objeto desde el que se realiza una copia. Si el nuevo objeto no se copia de otro objeto, este parámetro es NULL. Para obtener más información sobre las operaciones de copia, vea la sección Comentarios. Si este objeto se va a mantener más allá del ámbito de este método, el recuento de referencias debe incrementarse llamando a IUnknown::AddRef o IUnknown::QueryInterface.
[in] lpszClassName
Puntero a una cadena WCHAR que contiene el nombre LDAP de la clase de objeto que se va a crear. Este parámetro no debe ser NULL. Los valores admitidos son: "user", "computer", "printQueue", "group" y "contact".
[in] pDsAdminNewObj
Puntero a una interfaz IDsAdminNewObj que contiene datos adicionales sobre el asistente. También puede obtener la interfaz IDsAdminNewObjPrimarySite de la extensión principal llamando a QueryInterface con IID_IDsAdminNewObjPrimarySite en esta interfaz. Si este objeto se va a mantener más allá del ámbito de este método, el recuento de referencias debe incrementarse llamando a IUnknown::AddRef o IUnknown::QueryInterface.
[in] pDispInfo
Puntero a una estructura de DSA_NEWOBJ_DISPINFO que contiene datos adicionales sobre el Asistente para la creación de objetos.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente o si un código de error definido por OLE de lo contrario.
Comentarios
Un objeto de Servicios de dominio de Active Directory se puede crear a partir de nada o copiarse de un objeto existente. Si el nuevo objeto se crea a partir de un objeto existente, pADsCopySource contendrá un puntero al objeto desde el que se realiza la copia. Si el nuevo objeto no se copia de otro objeto, pADsCopySource será NULL. La operación de copia solo se admite para objetos de usuario.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | dsadmin.h |
| Archivo DLL | DSAdmin.dll |