RpcNsProfileEltInqNextW 函数 (rpcnsi.h)

  • 项目

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

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

语法

RPC_STATUS RpcNsProfileEltInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_WSTR      *MemberName,
  unsigned long *Priority,
  RPC_WSTR      *Annotation
);

参数

InquiryContext

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

IfId

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

MemberName

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

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

Priority

返回指向配置文件元素优先级的指针。

Annotation

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

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

返回值

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

注解

RpcNsProfileEltInqNext 函数从 RpcNsProfileEltInqBegin 中的 ProfileName 参数指定的配置文件中返回一个元素。 无论 RpcNsProfileEltInqBegin 中 InquiryType 的值如何，RpcNsProfileEltInqNext 都会返回配置文件元素 (接口标识、成员名称、优先级、注释字符串) 的所有组件。

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

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

注意 Windows 2000 Active Directory 支持此功能。 早期版本的 Windows NT 仅支持将此函数与单元格目录服务 (CDS) 配合使用。
 

注意

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

要求

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

另请参阅

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree