RoActivateInstance 함수(roapi.h)

  • 아티클

지정된 Windows 런타임 클래스를 활성화합니다.

구문

HRESULT RoActivateInstance(
  [in]  HSTRING      activatableClassId,
  [out] IInspectable **instance
);

매개 변수

[in] activatableClassId

형식: HSTRING

활성화 가능한 런타임 클래스와 연결된 클래스 식별자입니다.

[out] instance

형식: IInspectable**

런타임 클래스의 활성화된 instance 대한 포인터입니다.

반환 값

형식: HRESULT

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 클래스가 성공적으로 활성화되었습니다.
E_POINTER
 instanceNULL입니다.
CO_E_NOTINITIALIZED
 RoInitialize 함수를 호출하여 Windows 런타임 스레드가 초기화되지 않았습니다.
E_ACCESSDENIED
 클래스의 TrustLevel 에는 완전 신뢰 프로세스가 필요합니다.
E_NOINTERFACE
 IInspectable 인터페이스는 지정된 클래스에 의해 구현되지 않습니다.
E_OUTOFMEMORY
 클래스의 instance 만들지 못했습니다.

설명

RoActivateInstance 함수를 사용하여 Windows 런타임 클래스를 활성화합니다. RoActivateInstance 함수는 지정된 활성화 가능한 클래스 식별자와 연결된 활성화 팩터리에 연결하고, 클래스에서 인수가 없는 생성자를 호출하여 instance 만들고, 활성화 팩터리를 해제합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 roapi.h

추가 정보

CoCreateInstance

IActivationFactory

IInspectable

TrustLevel