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