RoGetServerActivatableClasses 函式 (roregistrationapi.h)
擷取針對指定可執行檔註冊的可啟用類別, (EXE) 伺服器,該伺服器是在呼叫進程的套件標識碼下註冊。
語法
HRESULT RoGetServerActivatableClasses(
[in] HSTRING serverName,
[out] HSTRING **activatableClassIds,
[out] DWORD *count
);
參數
[in] serverName
類型: HSTRING
要擷取類別註冊的伺服器名稱。 啟動伺服器時,此伺服器名稱會在命令行上傳遞。
[out] activatableClassIds
類型: HSTRING**
伺服器註冊要提供服務之可啟動類別標識符字串的被呼叫端配置陣列。 字串必須由呼叫端使用 WindowsDeleteString 函式釋放。 然後必須使用 CoTaskMemFree 釋放緩衝區。 伺服器 (呼叫端) 負責註冊這些類別的啟用處理站。
[out] count
類型: DWORD*
在 activatableClassIds 陣列中傳回的可啟用類別識別碼計數。
傳回值
類型: HRESULT
方法會在成功時 傳回S_OK ,否則會傳回錯誤碼,包括下列專案。
傳回碼 | Description |
---|---|
|
會提供空的伺服器名稱、未註冊伺服器,或未為此伺服器註冊任何類別。 |
|
進程沒有足夠的許可權可讀取此伺服器的註冊。 |
備註
使用 RoGetServerActivatableClasses 函式來擷取伺服器預期的類別名稱。 個別呼叫每個類別名稱上的 RoGetActivatableClassRegistration 函式,以取得個別類別的詳細數據。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | roregistrationapi.h |
程式庫 | Runtimeobject.lib |