IDsAdminCreateObj::CreateModal 메서드는 개체 만들기 마법사를 표시하고 새로 만든 개체를 반환합니다. IDsAdminCreateObj::CreateModal을 호출하려면 먼저 IDsAdminCreateObj::Initialize 메서드를 호출해야 합니다.
구문
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 가 유효한지 확인하는 것은 피해야 합니다. 인터페이스 포인터를 사용하기 전에 항상 NULL이 아닌 값에 대한 ppADsObj의 내용을 테스트합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | dsadmin.h |
| DLL | DSAdmin.dll |