通过

RpcMgmtEpEltInqNextW 函数 （rpcdce.h）

  • 项目

RpcMgmtEpEltInqNext 函数从终结点映射返回一个元素。

语法

RPC_STATUS RpcMgmtEpEltInqNextW(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_WSTR           *Annotation
);

参数

InquiryContext

指定查询上下文。 查询上下文从 RpcMgmtEpEltInqBegin返回。

IfId

返回终结点映射元素的接口标识符。

Binding

自选。 从终结点映射元素返回绑定句柄。

ObjectUuid

自选。 从终结点映射元素返回对象 UUID。

Annotation

自选。 返回终结点映射元素的批注字符串。 当终结点映射元素中没有批注字符串时，将返回空字符串（“”）。

返回值

价值 意义
RPC_S_OK
 调用成功。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcMgmtEpEltInqNext 函数从终结点映射返回一个元素。 所选元素取决于查询上下文。 选择条件由返回 InquiryContext的 RpcMgmtEpEltInqBegin 函数的 InquiryType 确定。

应用程序可以通过重复调用 rpcMgmtEpEltInqNext 来查看所有选定的终结点映射元素。 查看所有元素后，此函数将返回RPC_X_NO_MORE_ENTRIES状态。 返回的元素是无序的。

当相应的参数为非 NULL 时，RPC 运行时函数库会为每个调用此函数分配 绑定 和 批注 内存。 应用程序负责为每个返回的 绑定 调用 RpcBindingFree，并为每个返回 批注RpcStringFree。

查看终结点映射元素后，应用程序必须调用 RpcMgmtEpEltInqDone 才能删除查询上下文。

注意

rpcdce.h 标头将 RpcMgmtEpEltInqNext 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

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

另请参阅

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone