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

Статья
08/25/2023

Функция RpcEpUnregister удаляет сведения об адресе сервера из локальной базы данных endpoint-map.

Синтаксис

RPC_STATUS RpcEpUnregister(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector
);

Параметры

IfSpec

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

BindingVector

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

UuidVector

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

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

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

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

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

Функция RpcEpUnregister удаляет элементы из базы данных сопоставления конечных точек локального узла. Серверное приложение вызывает эту функцию только в том случае, если сервер ранее зарегистрировал конечные точки и сервер хочет удалить эти сведения об адресах из базы данных схемы конечных точек.

В частности, RpcEpUnregister позволяет серверным приложениям удалять собственные элементы базы данных схемы конечных точек (сведения об адресе сервера) на основе спецификации интерфейса или спецификации интерфейса и UUID объекта предлагаемых ресурсов.

Сервер вызывает функцию RpcServerInqBindings для получения необходимого параметра BindingVector . Чтобы отменить регистрацию выбранных конечных точек, сервер может удалить вектор привязки перед вызовом этой функции.

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

Требования

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

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

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings

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