Metodo IDsAdminNewObjExt::Initialize (dsadmin.h)
Il metodo IDsAdminNewObjExt::Initialize inizializza un'estensione della creazione guidata di oggetti.
Sintassi
HRESULT Initialize(
[in] IADsContainer *pADsContainerObj,
[in] IADs *pADsCopySource,
[in] LPCWSTR lpszClassName,
[in] IDsAdminNewObj *pDsAdminNewObj,
[in] LPDSA_NEWOBJ_DISPINFO pDispInfo
);
Parametri
[in] pADsContainerObj
Puntatore all'interfaccia IADsContainer di un contenitore esistente in cui viene creato l'oggetto. Questo parametro non deve essere NULL. Se questo oggetto deve essere mantenuto oltre l'ambito di questo metodo, il conteggio dei riferimenti deve essere incrementato chiamando IUnknown::AddRef o IUnknown::QueryInterface.
[in] pADsCopySource
Puntatore all'interfaccia ID dell'oggetto da cui viene eseguita una copia. Se il nuovo oggetto non viene copiato da un altro oggetto, questo parametro è NULL. Per altre informazioni sulle operazioni di copia, vedere la sezione Osservazioni. Se questo oggetto deve essere mantenuto oltre l'ambito di questo metodo, il conteggio dei riferimenti deve essere incrementato chiamando IUnknown::AddRef o IUnknown::QueryInterface.
[in] lpszClassName
Puntatore a una stringa WCHAR contenente il nome LDAP della classe oggetto da creare. Questo parametro non deve essere NULL. I valori supportati sono: "user", "computer", "printQueue", "group" e "contact".
[in] pDsAdminNewObj
Puntatore a un'interfaccia IDsAdminNewObj che contiene dati aggiuntivi sulla procedura guidata. È anche possibile ottenere l'interfaccia IDsAdminNewObjPrimarySite dell'estensione primaria chiamando QueryInterface con IID_IDsAdminNewObjPrimarySite su questa interfaccia. Se questo oggetto deve essere mantenuto oltre l'ambito di questo metodo, il conteggio dei riferimenti deve essere incrementato chiamando IUnknown::AddRef o IUnknown::QueryInterface.
[in] pDispInfo
Puntatore a una struttura DSA_NEWOBJ_DISPINFO che contiene dati aggiuntivi sulla creazione guidata dell'oggetto.
Valore restituito
Restituisce S_OK se ha esito positivo o se un codice di errore definito da OLE in caso contrario.
Commenti
Un oggetto in Active Directory Domain Services può essere creato da nulla o copiato da un oggetto esistente. Se il nuovo oggetto viene creato da un oggetto esistente, pADsCopySource conterrà un puntatore all'oggetto da cui viene eseguita la copia. Se il nuovo oggetto non viene copiato da un altro oggetto, pADsCopySource sarà NULL. L'operazione di copia è supportata solo per gli oggetti utente.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | dsadmin.h |
| DLL | DSAdmin.dll |