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

Статья
08/25/2023

[Эта функция поддерживается только в Windows NT и Windows Me/98/95; она возвращает EP_S_CANT_PERFORM_OP в других версиях Windows.]

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

Синтаксис

RPC_STATUS RpcMgmtEpUnregister(
  RPC_BINDING_HANDLE EpBinding,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

Параметры

EpBinding

Узел, элементы карты конечной точки которого необходимо отменить регистрацию. Чтобы удалить элементы с того же узла, что и вызывающее приложение, приложение задает значение NULL. Чтобы удалить элементы с другого узла, приложение указывает дескриптор привязки сервера для любого сервера, размещенного на этом узле. Обратите внимание, что приложение может указать тот же дескриптор привязки, который используется для выполнения других удаленных вызовов процедур.

IfId

Идентификатор интерфейса, удаляемого из карты конечных точек.

Binding

Дескриптор привязки для удаления.

ObjectUuid

Необязательный объект UUID для удаления. Значение NULL указывает, что объект UUID для удаления отсутствует.

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

Код возврата	Описание
RPC_S_OK	Вызов выполнен успешно.
RPC_S_CANT_PERFORM_OP	Не удается выполнить запрошенную операцию.

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

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

Параметр EpBinding должен быть полной привязкой. Объект UUID, связанный с параметром EpBinding , должен быть UUID nil. Указание UUID, отличного от nil, приводит к сбою функции с кодом состояния EPT_S_CANT_PERFORM_OP. Кроме сведений об узле и UUID объекта, все сведения в этом аргументе игнорируются.

Приложение вызывает RpcMgmtEpEltInqNext для просмотра локальных элементов карты конечных точек. Затем приложение может удалить элементы с помощью RpcMgmtEpUnregister.

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