Метод IDsAdminCreateObj::CreateModal (dsadmin.h)
Метод IDsAdminCreateObj::CreateModal отображает мастер создания объектов и возвращает только что созданный объект. Перед вызовом метода IDsAdminCreateObj::Initialize необходимо вызвать метод IDsAdminCreateObj::CreateModal .
Синтаксис
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
Параметры
[in] hwndParent
Содержит дескриптор окна владельца мастера. Это значение не может иметь значение NULL. Используйте результат функции GetDesktopWindow, если родительское окно недоступно.
[out] ppADsObj
Указатель на указатель интерфейса IAD, который получает только что созданный объект. Этот параметр получает значение NULL , если мастер создания объектов завершается сбоем или отменяется. Вызывающий объект должен освободить этот интерфейс, если он больше не требуется. Этот параметр может иметь значение NULL , если этот объект не является обязательным.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Возвращает код ошибки, определенный OLE, или одно из следующих значений.
Комментарии
Если пользователь отменяет работу мастера создания объектов, этот метод возвращает S_FALSE. Если ppADsObj не равно NULL, ppADsObj получает значение NULL . Поэтому следует избегать использования макроса SUCCEEDED для определения допустимости ppADsObj . Перед использованием указателя интерфейса всегда проверяйте содержимое ppADsObj на наличие значения, отличного от NULL .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | dsadmin.h |
| DLL | DSAdmin.dll |