Metodo IDsAdminNewObjExt::Initialize (dsadmin.h)

Articolo
08/23/2023

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