Функция RpcServerInterfaceGroupActivate (rpcdce.h)

Статья
03/01/2024

Функция RpcServerInterfaceGroupActivate сообщает среде выполнения сервера RPC зарегистрировать интерфейсы и конечные точки группы интерфейсов и начать прослушивание вызовов.

Синтаксис

RPC_STATUS RpcServerInterfaceGroupActivate(
  [in] RPC_INTERFACE_GROUP IfGroup
);

Параметры

[in] IfGroup

RPC_INTERFACE_GROUP из RpcServerInterfaceGroupCreate, который определяет группу интерфейсов для активации.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_PROTSEQ_NOT_SUPPORTED	Последовательность протоколов не поддерживается на этом узле.
RPC_S_INVALID_RPC_PROTSEQ	Недопустимая последовательность протокола.
RPC_S_INVALID_ENDPOINT_FORMAT	Недопустимый формат конечной точки.
RPC_S_OUT_OF_MEMORY	Системе не хватает памяти.
RPC_S_INVALID_SECURITY_DESC	Недопустимый дескриптор безопасности для конечной точки или интерфейса.

Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.

Указывает среде выполнения RPC начать прослушивание вызовов.
Регистрирует конечные точки в среде выполнения сервера.
Регистрирует интерфейсы в среде выполнения сервера.
Регистрирует конечные точки и интерфейсы с помощью модуля сопоставления конечных точек RPC.

RpcServerInterfaceGroupActivate является атомарным. Если в какой-либо момент операция завершается сбоем, все ранее зарегистрированные элементы удаляются.

Вызовы могут быть отправлены в серверное приложение до возврата этой функции.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	rpcdce.h (включая Rpc.h)
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также раздел

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings

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