Méthode IDsAdminCreateObj ::CreateModal (dsadmin.h)
La méthode IDsAdminCreateObj ::CreateModal affiche l’Assistant Création d’objet et retourne l’objet nouvellement créé. La méthode IDsAdminCreateObj ::Initialize doit être appelée avant que IDsAdminCreateObj ::CreateModal puisse être appelé.
Syntaxe
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
Paramètres
[in] hwndParent
Contient le handle de fenêtre du propriétaire de l’Assistant. Cette valeur ne peut pas être NULL. Utilisez le résultat de la fonction GetDesktopWindow si aucune fenêtre parente n’est disponible.
[out] ppADsObj
Pointeur vers un pointeur d’interface IADs qui reçoit l’objet nouvellement créé. Ce paramètre reçoit la valeur NULL si l’Assistant Création d’objet échoue ou est annulé. L’appelant doit libérer cette interface lorsqu’elle n’est plus nécessaire. Ce paramètre peut avoir la valeur NULL si cet objet n’est pas obligatoire.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Retourne un code d’erreur défini par OLE ou l’une des valeurs suivantes.
Remarques
Si l’utilisateur annule l’Assistant création d’objet, cette méthode retourne S_FALSE. Si ppADsObj n’a pas la valeur NULL, ppADsObj reçoit une valeur NULL . Pour cette raison, l’utilisation de la macro SUCCEEDED pour déterminer si ppADsObj est valide doit être évitée. Testez toujours le contenu de ppADsObj pour une valeur non NULL avant d’utiliser le pointeur d’interface.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |