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

  • Статья

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

Синтаксис

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

Параметры

EpBinding

Дескриптор привязки к узлу, элементы карты конечных точек которого необходимо просмотреть. Укажите ЗНАЧЕНИЕ NULL для просмотра элементов из локального узла. Если указан дескриптор привязки, объект UUID в дескрипторе привязки должен иметь значение NULL. При наличии конечная точка в дескрипторе привязки игнорируется и используется конечная точка для базы данных сопоставителя конечных точек на данном узле.

InquiryType

Целочисленное значение, указывающее тип запроса, выполняемого в сопоставлении конечных точек. Ниже приведены допустимые типы запросов.

Значение Значение
RPC_C_EP_ALL_ELTS
 Возвращает каждый элемент из карты конечных точек. Параметры IfId, VersOption и ObjectUuid игнорируются.
RPC_C_EP_MATCH_BY_IF
 Выполняет поиск в сопоставлении конечных точек элементов, содержащих идентификатор интерфейса, указанный значениями IfId и VersOption .
RPC_C_EP_MATCH_BY_OBJ
 Выполняет поиск элементов, содержащих объект UUID, указанный objectUuid в сопоставлении конечных точек.
RPC_C_EP_MATCH_BY_BOTH
 Выполняет поиск в сопоставлении конечных точек элементов, содержащих идентификатор интерфейса и UUID объекта, указанные ifId, VersOption и ObjectUuid.

IfId

Идентификатор интерфейса элементов карты конечной точки, возвращаемых RpcMgmtEpEltInqNext. Этот параметр используется только в том случае, если параметр InquiryType имеет RPC_C_EP_MATCH_BY_IF или RPC_C_EP_MATCH_BY_BOTH. В других случаях он игнорируется.

VersOption

Указывает, как RpcMgmtEpEltInqNext использует параметр IfId . Этот параметр используется только в том случае, если параметр InquiryType имеет RPC_C_EP_MATCH_BY_IF или RPC_C_EP_MATCH_BY_BOTH. В других случаях он игнорируется. Ниже приведены допустимые значения для этого параметра.

Значение Значение
RPC_C_VERS_ALL
 Возвращает элементы карты конечных точек, которые предлагают указанный UUID интерфейса, независимо от номеров версий.
RPC_C_VERS_COMPATIBLE
 Возвращает элементы карты конечных точек, которые предлагают ту же основную версию указанного UUID интерфейса и дополнительную версию, которая больше или равна дополнительной версии указанного UUID интерфейса.
RPC_C_VERS_EXACT
 Возвращает элементы схемы конечных точек, которые предлагают указанную версию указанного UUID интерфейса.
RPC_C_VERS_MAJOR_ONLY
 Возвращает элементы карты конечной точки, которые предлагают ту же основную версию указанного интерфейса UUID и игнорируют дополнительную версию.
RPC_C_VERS_UPTO
 Возвращает элементы карты конечных точек, которые предлагают версию указанного UUID интерфейса, которая меньше или равна указанной основной и дополнительной версии.

ObjectUuid

UUID объекта, который RpcMgmtEpEltInqNext ищет в элементах схемы конечных точек. Этот параметр используется только в том случае, если параметр InquiryType имеет значение RPC_C_EP_MATCH_BY_OBJ или RPC_C_EP_MATCH_BY_BOTH.

InquiryContext

Возвращает контекст запроса для использования с RpcMgmtEpEltInqNext и RpcMgmtEpEltInqDone. См . RPC_EP_INQ_HANDLE.

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

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

Комментарии

Функция RpcMgmtEpEltInqBegin создает контекст запроса для просмотра сведений об адресе сервера, хранящихся в сопоставлении конечных точек. Используя ЗапросType и VersOption, приложение указывает, какие из следующих элементов схемы конечных точек должны возвращаться из вызовов RpcMgmtEpEltInqNext:

  • Все элементы
  • Эти элементы с указанным идентификатором интерфейса
  • Эти элементы с указанным объектом UUID
  • Эти элементы с указанным идентификатором интерфейса и UUID объекта
Перед вызовом RpcMgmtEpEltInqNext приложение должно сначала вызвать эту функцию, чтобы создать контекст запроса. После просмотра элементов схемы конечных точек приложение вызывает RpcMgmtEpEltInqDone , чтобы удалить контекст запроса.

Требования

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

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

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext