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

Article
08/23/2023

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