RpcNsEntryObjectInqNext 函数 (rpcnsi.h)

RpcNsEntryObjectInqNext 函数一次从名称服务数据库条目返回一个对象。

注意 Windows Vista 及更高版本的操作系统不支持此功能。

语法

RPC_STATUS RpcNsEntryObjectInqNext(
  RPC_NS_HANDLE InquiryContext,
  UUID          *ObjUuid
);

InquiryContext

名称服务句柄，指示名称服务数据库条目的对象 UUID。

ObjUuid

返回指向导出对象 UUID 的指针。

值	含义
RPC_S_OK	调用成功。
RPC_S_NO_MORE_MEMBERS	不再有成员。
RPC_S_INCOMPLETE_NAME	名称不完整。
RPC_S_ENTRY_NOT_FOUND	找不到名称服务条目。
RPC_S_NAME_SERVICE_UNAVAILABLE	名称服务不可用。

注意有关有效错误代码的列表，请参阅 RPC 返回值。

RpcNsEntryObjectInqNext 函数返回导出到 RpcNsEntryObjectInqBegin 函数中的 EntryName 参数指定的 name-service 数据库条目的对象 UUID 之一。

应用程序可以通过重复调用 RpcNsEntryObjectInqNext 来查看所有导出的对象 UUID。查看所有对象 UUID 后，此函数将返回RPC_S_NO_MORE_MEMBERS状态代码。返回的对象 UUID 是无序的。

应用程序为 在 ObjUuid 参数中返回的对象 UUID 提供内存。

查看对象 UUID 后，应用程序必须调用 RpcNsEntryObjectInqDone 函数来释放查询上下文。

每次查看条目时，返回对象 UUID 的顺序可能不同。这意味着，每次运行应用程序时，对象 UUID 返回到应用程序的顺序可能不同。

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