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

另请参阅

GetDesktopWindow

IAD

IDsAdminCreateObj

IDsAdminCreateObj::Initialize

已成功