RoActivateInstance 函式 (roapi.h)

啟動指定的 Windows 執行階段類別。

語法

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

[in] activatableClassId

類型： HSTRING

與可啟用運行時間類別相關聯的類別標識碼。

[out] instance

運行時間類別啟動實例的指標。

類型： HRESULT

此函式可以傳回其中一個值。

傳回碼	描述
S_OK	類別已成功啟動。
E_POINTER	實例為 NULL。
CO_E_NOTINITIALIZED	呼叫 RoInitialize 函式，在 Windows 執行階段中尚未初始化線程。
E_ACCESSDENIED	類別的 TrustLevel 需要完全信任的程式。
E_NOINTERFACE	指定的類別不會實作 IInspectable 介面。
E_OUTOFMEMORY	無法建立類別的實例。

使用 RoActivateInstance 函式來啟用 Windows 執行階段類別。 RoActivateInstance 函式會連線到與指定可啟動類別標識符相關聯的啟用處理站、在類別上呼叫零自變數建構函式來建立實例，並釋放啟用處理站。

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	roapi.h