RpcNsMgmtEntryInqIfIdsA 函数 (rpcnsi.h)
RpcNsMgmtEntryInqIfIds 函数返回导出到名称服务数据库条目的接口列表。 它还返回一个接口标识向量,其中包含服务器导出到 EntryName 的绑定句柄的接口。 此函数的过期期限为 0,导致立即更新名称服务数据的本地副本。
注意 Windows Vista 及更高版本的操作系统不支持此功能。
语法
RPC_STATUS RpcNsMgmtEntryInqIfIdsA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_ID_VECTOR **IfIdVec
);
参数
EntryNameSyntax
EntryName 的语法。
若要使用注册表值项 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax中指定的语法,请提供值 RPC_C_NS_SYNTAX_DEFAULT。
EntryName
指向为其返回接口标识向量的名称 service-database 条目名称的指针。
IfIdVec
返回指向接口标识向量的指针的地址。
返回值
值 | 含义 |
---|---|
|
调用成功。 |
|
名称语法无效。 |
|
不支持名称语法。 |
|
名称不完整。 |
|
找不到名称服务条目。 |
|
名称服务不可用。 |
注意 有关有效错误代码的列表,请参阅 RPC 返回值。
注解
RpcNsMgmtEntryInqIfIds 函数返回接口标识向量,其中包含服务器导出到 EntryName 的绑定句柄的接口。 此函数的过期期限为 0,导致立即更新名称服务数据的本地副本。 调用应用程序负责调用 RpcIfIdVectorFree 函数以释放矢量使用的内存。
注意
rpcnsi.h 标头将 RpcNsMgmtEntryInqIfIds 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | rpcnsi.h (包括 Rpc.h) |
Library | Rpcns4.lib |
DLL | Rpcns4.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈