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

Статья
11/20/2024

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

Синтаксис

RPC_STATUS RpcMgmtEpEltInqNextA(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_CSTR           *Annotation
);

Параметры

InquiryContext

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

IfId

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

Binding

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

ObjectUuid

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

Annotation

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

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.

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

Замечания

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

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

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcdce.h (include Rpc.h)
библиотеки	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также

RpcEpRegister

RpcMgmtEptInqBegin

RpcMgmtEpEltInqDone

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