RoGetServerActivatableClasses 函数 (roregistrationapi.h)
检索为在调用进程的包 ID 下注册的给定可执行文件 (EXE) 服务器注册的可激活类。
语法
HRESULT RoGetServerActivatableClasses(
[in] HSTRING serverName,
[out] HSTRING **activatableClassIds,
[out] DWORD *count
);
参数
[in] serverName
类型: HSTRING
要为其检索类注册的服务器的名称。 激活服务器时,此服务器名称在命令行上传递。
[out] activatableClassIds
类型: HSTRING**
被调用方分配的可激活类 ID 字符串数组,服务器已注册为该字符串提供服务。 调用方必须使用 WindowsDeleteString 函数释放字符串。 然后,必须使用 CoTaskMemFree 释放缓冲区。 服务器 (调用方) 负责注册这些类的激活工厂。
[out] count
类型: DWORD*
在 activatableClassIds 数组中返回的可激活类 ID 的计数。
返回值
类型: HRESULT
该方法在成功 时返回S_OK ,否则返回错误代码,包括以下内容。
返回代码 | 说明 |
---|---|
|
提供了空的服务器名称,未注册服务器,或者没有为此服务器注册任何类。 |
|
进程没有足够的权限来读取此服务器的注册。 |
注解
使用 RoGetServerActivatableClasses 函数检索服务器应提供服务的类名称。 通过对每个类名称单独调用 RoGetActivatableClassRegistration 函数,获取有关各个类的详细信息。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | roregistrationapi.h |
Library | Runtimeobject.lib |