IDsAdminCreateObj::CreateModal 메서드(dsadmin.h)

아티클
08/23/2023

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