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
 在终结点映射中搜索包含 ObjectUuid 指定的对象 UUID 的元素。
RPC_C_EP_MATCH_BY_BOTH
 在终结点映射中搜索包含 IfId、 VersOption 和 ObjectUuid 指定的接口标识符和对象 UUID 的元素。

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

RpcMgmtEpEltInqNext 在终结点映射元素中查找的对象 UUID。 仅当 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 函数创建查询上下文，用于查看存储在终结点映射中的服务器地址信息。 使用 InquiryType 和 VersOption，应用程序指定要从对 RpcMgmtEpEltInqNext 的调用返回以下哪些终结点映射元素：

  • 所有元素
  • 具有指定接口标识符的元素
  • 具有指定对象 UUID 的那些元素
  • 具有指定接口标识符和对象 UUID 的元素
在调用 RpcMgmtEpEltInqNext 之前，应用程序必须先调用此函数来创建查询上下文。 查看终结点映射元素后，应用程序将调用 RpcMgmtEpEltInqDone 以删除查询上下文。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

另请参阅

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext