IDsAdminCreateObj::CreateModal 方法 (dsadmin.h)
IDsAdminCreateObj::CreateModal 方法显示对象创建向导并返回新创建的对象。 必须先调用 IDsAdminCreateObj::Initialize 方法,然后才能调用 IDsAdminCreateObj::CreateModal 。
语法
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
参数
[in] hwndParent
包含向导所有者的窗口句柄。 此值不能为 NULL。 如果没有可用的父窗口,请使用 GetDesktopWindow 函数的结果。
[out] ppADsObj
指向接收新创建对象的 IADs 接口指针的指针。 如果对象创建向导失败或被取消,此参数将接收 NULL 。 当不再需要此接口时,调用方必须释放该接口。 如果不需要此对象,则此参数可能为 NULL 。
返回值
此方法可以返回其中一个值。
返回 OLE 定义的错误代码或以下值之一。
注解
如果用户取消对象创建向导,此方法将返回S_FALSE。 如果 ppADsObj 不是 NULL, 则 ppADsObj 接收 NULL 值。 因此,应避免使用 SUCCEEDED 宏来确定 ppADsObj 是否有效。 在使用接口指针之前,请始终测试 ppADsObj 的内容是否为非 NULL 值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | dsadmin.h |
DLL | DSAdmin.dll |