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

Статья
03/05/2024

Функция RpcEpRegister добавляет или заменяет сведения об адресе сервера в локальной базе данных сопоставления конечных точек.

Синтаксис

RPC_STATUS RpcEpRegisterW(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector,
  RPC_WSTR           Annotation
);

Параметры

IfSpec

Интерфейс для регистрации в локальной базе данных карты конечных точек.

BindingVector

Указатель на вектор дескрипторов привязки, по которым сервер может принимать удаленные вызовы процедур.

UuidVector

Указатель на вектор объектов UUID, предлагаемых сервером. Серверное приложение создает этот вектор. Значение аргумента NULL указывает на отсутствие идентификаторов UUID объекта для регистрации.

Annotation

Указатель на символьный комментарий, примененный к каждому элементу кросс-продукта, добавленному в локальную базу данных на карте конечных точек. Строка может содержать до 64 символов, включая завершающий символ NULL. Укажите значение NULL или строку, завершаемую null ("\0"), если строка заметки отсутствует.

Строка заметки используется приложениями только для получения сведений. RPC не использует эту строку для определения экземпляра сервера, с которым взаимодействует клиент, или для перечисления элементов в базе данных сопоставления конечных точек.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_NO_BINDINGS	Нет привязок.
RPC_S_INVALID_BINDING	Недопустимый дескриптор привязки.
RPC_S_WRONG_KIND_OF_BINDING	Это был неправильный тип привязки для операции.

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

Функция RpcEpRegister добавляет или заменяет записи в базе данных сопоставления конечных точек локального узла. Для существующей записи базы данных, которая соответствует предоставленной спецификации интерфейса, дескриптору привязки и UUID объекта, эта функция заменяет конечную точку записи конечной точкой в предоставленном дескрипторе привязки.

Сервер может использовать RpcEpRegister и RpcEpRegisterNoReplace для регистрации записей в базе данных сопоставителя конечных точек. До Windows 2000 были доступны две функции, позволяющие серверу перезаписывать устаревшие записи в базе данных сопоставителя конечных точек, оставшейся от предыдущих экземпляров сервера, которые больше не работают. База данных сопоставителя конечных точек автоматически удаляет записи, зарегистрированные экземпляром сервера, как только сервер перестает работать. Однако серверы не могут заменять записи сопоставителя конечных точек другого сервера в целях безопасности. Таким образом, RpcEpRegister и RpcEpRegisterNoReplace выполняют практически одинаковые функции.

Серверное приложение вызывает RpcEpRegister для регистрации конечных точек, указанных путем вызова любой из следующих функций:

Если сервер также выполняет экспорт в базу данных name-service, сервер вызывает RpcEpRegister с теми же значениями IfSpec, BindingVector и UuidVector , которые использовались при вызове функции RpcNsBindingExport .

Если последовательность протоколов используется без указания конечной точки, библиотека времени выполнения RPC автоматически создает динамическую конечную точку. В этом случае сервер может вызвать RpcServerInqBindings , а затем RpcEpRegister , чтобы сделать себя доступным для нескольких клиентов. В противном случае автоматически запущенный сервер будет известен только клиенту, для которого был запущен сервер. Каждый элемент, добавленный в базу данных схемы конечных точек, логически содержит следующее:

UUID интерфейса
Версия интерфейса (основной и дополнительный)
Дескриптор привязки
Объект UUID (необязательно)
Заметка (необязательно)

RpcEpRegister создает кросс-продукт на основе параметров IfSpec, BindingVector и UuidVector и добавляет каждый элемент в кросс-продукт в качестве отдельной регистрации в базе данных карты конечных точек.

Примечание

Заголовок rpcdce.h определяет RpcEpRegister как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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