Share via

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

  • Статья

Функция RpcMgmtEpEltInqNext возвращает один элемент из карты конечных точек.

Синтаксис

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  RPC_CSTR           *Annotation
);

Параметры

InquiryContext

Указывает контекст запроса. Контекст запроса возвращается из RpcMgmtEpEltInqBegin.

IfId

Возвращает идентификатор интерфейса элемента endpoint-map.

Binding

Необязательный элемент. Возвращает дескриптор привязки из элемента endpoint-map.

Annotation

Необязательный элемент. Возвращает строку заметки для элемента endpoint-map. Если в элементе endpoint-map нет строки заметки, возвращается пустая строка ("").

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

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

Комментарии

Функция RpcMgmtEpEltInqNext возвращает один элемент из карты конечных точек. Выбранные элементы зависят от контекста запроса. Критерии выбора определяются Типом запроса функции RpcMgmtEpEltInqBegin , возвращающей ЗапросContext.

Приложение может просматривать все выбранные элементы карты конечных точек, многократно вызывая RpcMgmtEpEltInqNext. После просмотра всех элементов эта функция возвращает состояние RPC_X_NO_MORE_ENTRIES. Возвращаемые элементы не упорядочены.

Если соответствующие аргументы не имеют значения NULL, библиотека функций времени выполнения RPC выделяет память для привязки и заметки при каждом вызове этой функции. Приложение отвечает за вызов RpcBindingFree для каждой возвращенной привязки и RpcStringFree для каждой возвращенной заметки.

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

Требования

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

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

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone