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 ,否则返回错误代码,包括以下内容。

返回代码 说明
REGDB_E_CLASSNOTREG
提供了空的服务器名称,未注册服务器,或者没有为此服务器注册任何类。
E_ACCESSDENIED
进程没有足够的权限来读取此服务器的注册。

注解

使用 RoGetServerActivatableClasses 函数检索服务器应提供服务的类名称。 通过对每个类名称单独调用 RoGetActivatableClassRegistration 函数,获取有关各个类的详细信息。

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 roregistrationapi.h
Library Runtimeobject.lib