通过

RpcNsProfileEltInqNextA 函数 （rpcnsi.h）

  • 项目

RpcNsProfileEltInqNext 函数从配置文件一次返回一个元素。

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

语法

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

参数

InquiryContext

从 RpcNsProfileEltInqBegin 函数返回的名称服务句柄。

IfId

返回指向配置文件元素的接口标识的指针。

MemberName

返回指向配置文件元素成员名称的指针的指针。返回名称的语法是由 RpcNsProfileEltInqBegin 函数中的 MemberNameSyntax 参数指定的。

指定 null 值以防止 RpcNsProfileEltInqNext 返回 MemberName 参数。 在这种情况下，应用程序不会调用 RpcStringFree 函数。

Priority

返回指向 profile-element 优先级的指针。

Annotation

返回指向指向配置文件元素的批注字符串的指针的指针。 如果配置文件元素中没有批注字符串，则返回字符串 \0。

指定 null 值以防止 RpcNsProfileEltInqNext 返回 批注 参数。 在这种情况下，应用程序不需要调用 RpcStringFree 函数。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INCOMPLETE_NAME
 名称不完整。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名称服务不可用。
RPC_S_NO_MORE_ELEMENTS
 不再有元素。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcNsProfileEltInqNext 函数从 RpcNsProfileEltInqBegin中的 ProfileName 参数指定的配置文件中返回一个元素。 无论 RpcNsProfileEltInqBegin中 查询类型 的值如何，RpcNsProfileEltInqNext 返回配置文件元素的所有组件（接口标识、成员名称、优先级、批注字符串）。

应用程序可以通过重复调用 RpcNsProfileEltInqNext 函数来查看所有选定的配置文件条目。 查看所有元素后，此函数将返回RPC_S_NO_MORE_ELEMENTS状态代码。 返回的元素是无序的。

每次调用 RpcNsProfileEltInqNext 返回配置文件元素时，RPC 运行时库将为返回的成员名称和批注字符串分配内存。 应用程序负责为每个返回的成员名称和批注字符串调用 RpcStringFree 函数。 查看配置文件的元素后，应用程序必须调用 RpcNsProfileEltInqDone 才能释放查询上下文。

注意 Windows 2000 Active Directory 支持此函数。 早期版本的 Windows NT 仅支持将此函数与 Cell Directory 服务（CDS）配合使用。
 

注意

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

要求

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

另请参阅

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree