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

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

  • Статья

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

Комментарии

RpcServerInterfaceGroupActivate выполняет основную часть работы по инициализации, которую необходимо выполнить приложениям сервера RPC. Он выполняет следующие операции:

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

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

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

Требования

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

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

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings