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

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

Annotation

可选。 返回终结点映射元素的批注字符串。 如果 endpoint-map 元素中没有批注字符串，则返回空字符串 (“”) 。

返回值

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

注解

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

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

当各自的参数为非 NULL 时，RPC 运行时函数库在每次调用此函数时都会为 Binding 和 Annotation 分配内存。 应用程序负责为每个返回的 Binding 调用 RpcBindingFree，为每个返回的批注调用 RpcStringFree。

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

要求

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

另请参阅

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone