Méthode IDsAdminNewObjExt::Initialize (dsadmin.h)
La méthode IDsAdminNewObjExt::Initialize initialise une extension de l’Assistant Création d’objets.
Syntaxe
HRESULT Initialize(
[in] IADsContainer *pADsContainerObj,
[in] IADs *pADsCopySource,
[in] LPCWSTR lpszClassName,
[in] IDsAdminNewObj *pDsAdminNewObj,
[in] LPDSA_NEWOBJ_DISPINFO pDispInfo
);
Paramètres
[in] pADsContainerObj
Pointeur vers l’interface IADsContainer d’un conteneur existant dans lequel l’objet est créé. Ce paramètre ne doit pas avoir la valeur NULL. Si cet objet doit être conservé au-delà de l’étendue de cette méthode, le nombre de références doit être incrémenté en appelant IUnknown::AddRef ou IUnknown::QueryInterface.
[in] pADsCopySource
Pointeur vers l’interface IADs de l’objet à partir duquel une copie est effectuée. Si le nouvel objet n’est pas copié à partir d’un autre objet, ce paramètre a la valeur NULL. Pour plus d’informations sur les opérations de copie, consultez la section Remarques. Si cet objet doit être conservé au-delà de l’étendue de cette méthode, le nombre de références doit être incrémenté en appelant IUnknown::AddRef ou IUnknown::QueryInterface.
[in] lpszClassName
Pointeur vers une chaîne WCHAR contenant le nom LDAP de la classe d’objet à créer. Ce paramètre ne doit pas avoir la valeur NULL. Les valeurs prises en charge sont : « user », « computer », « printQueue », « group » et « contact ».
[in] pDsAdminNewObj
Pointeur vers une interface IDsAdminNewObj qui contient des données supplémentaires sur l’Assistant. Vous pouvez également obtenir l’interface IDsAdminNewObjPrimarySite de l’extension principale en appelant QueryInterface avec IID_IDsAdminNewObjPrimarySite sur cette interface. Si cet objet doit être conservé au-delà de l’étendue de cette méthode, le nombre de références doit être incrémenté en appelant IUnknown::AddRef ou IUnknown::QueryInterface.
[in] pDispInfo
Pointeur vers une structure DSA_NEWOBJ_DISPINFO qui contient des données supplémentaires sur l’Assistant Création d’objets.
Valeur retournée
Retourne S_OK en cas de réussite ou un code d’erreur défini par OLE dans le cas contraire.
Notes
Un objet dans services de domaine Active Directory peut être créé à partir de rien ou copié à partir d’un objet existant. Si le nouvel objet est créé à partir d’un objet existant, pADsCopySource contient un pointeur vers l’objet à partir duquel la copie est effectuée. Si le nouvel objet n’est pas copié à partir d’un autre objet, pADsCopySource aura la valeur NULL. L’opération de copie est uniquement prise en charge pour les objets utilisateur.
Spécifications
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | dsadmin.h |
| DLL | DSAdmin.dll |