Поделиться через

Функция 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*

Число идентификаторов активируемых классов, возвращаемых в массиве активируемыхClassIds .

Возвращаемое значение

Тип: HRESULT

Метод возвращает S_OK при успешном выполнении, в противном случае — код ошибки, включая следующий код.

Код возврата Описание
REGDB_E_CLASSNOTREG
 Указано пустое имя сервера, сервер не зарегистрирован или для этого сервера не зарегистрированы классы.
E_ACCESSDENIED
 Процесс не имеет достаточных разрешений для чтения регистрации этого сервера.

Комментарии

Используйте функцию RoGetServerActivatableClasses , чтобы получить имена классов, которые должен обслуживать сервер. Получение сведений об отдельных классах путем вызова функции RoGetActivatableClassRegistration для каждого имени класса по отдельности.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header roregistrationapi.h
Библиотека Runtimeobject.lib