通过

RpcNsBindingLookupBeginA 函数 （rpcnsi.h）

  • 项目

RpcNsBindingLookupBegin 函数为接口和对象创建查找上下文。

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

语法

RPC_STATUS RpcNsBindingLookupBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  unsigned long BindingMaxCount,
  RPC_NS_HANDLE *LookupContext
);

参数

EntryNameSyntax

EntryName 参数的语法。

若要使用注册表值项 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax中指定的语法，请提供一个RPC_C_NS_SYNTAX_DEFAULT值。

EntryName

指向在其中开始搜索兼容绑定的条目名称的指针。

若要使用注册表值项 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry中指定的项名称，请提供空指针或空字符串。 在这种情况下，将忽略 EntryNameSyntax 参数，并且运行时库使用默认语法。

IfSpec

存根生成的结构，指示要查找的接口。 如果接口规范尚未导出或对调用方无关，请为此参数指定 null 值。 在这种情况下，仅保证返回的绑定是兼容且受支持的协议序列，并且包含指定的对象 UUID。 联系人服务器可能不支持所需的接口。

ObjUuid

指向可选对象 UUID 的指针。

对于非零 UUID，仅当服务器导出了指定的对象 UUID 时，才从条目返回兼容的绑定句柄。

对于此参数的 null 指针值或 nil UUID，返回的绑定句柄包含兼容服务器导出的对象 UUID 之一。 如果服务器未导出任何对象 UUID，则返回的兼容绑定句柄包含 nil 对象 UUID。

BindingMaxCount

RpcNsBindingLookupNext 函数 BindingVec 参数中要返回的最大绑定数。

指定一个零值以使用默认RPC_C_BINDING_MAX_COUNT_DEFAULT计数。

LookupContext

返回指向名称服务句柄的指针，该句柄与 RpcNsBindingLookupNext 和 RpcNsBindingLookupDone 函数一起使用。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INVALID_NAME_SYNTAX
 名称语法无效。
RPC_S_UNSUPPORTED_NAME_SYNTAX
 不支持名称语法。
RPC_S_INCOMPLETE_NAME
 名称不完整。
RPC_S_ENTRY_NOT_FOUND
 找不到名称服务条目。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名称服务不可用。
RPC_S_INVALID_OBJECT
 无效对象。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcNsBindingLookupBegin 函数创建查找上下文，用于将客户端兼容的绑定句柄定位到提供指定接口和对象的服务器。

在调用 RpcNsBindingLookupNext之前，客户端应用程序必须先调用 RpcNsBindingLookupBegin 来创建查找上下文。 此函数的参数控制 RpcNsBindingLookupNext 函数的操作。

在 Windows 2000 中，RPC 环境使用 Active Directory 作为其名称服务数据库，运行时环境执行搜索的顺序如下所示：

  • 在本地缓存中搜索。
  • 如果未在本地缓存中找到条目，请搜索该计算机的 Active Directory。
  • 如果未在本地计算机上找到条目，请将广播请求发送到域中所有其他 Active Directory 服务。

    请注意，如果 Active Directory 中存在该条目，但没有与该条目关联的信息，则运行时环境将不会发出此广播请求。

定位完绑定句柄后，客户端应用程序调用 RpcNsBindingLookupDone 函数来删除查找上下文。

注意

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

要求

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

另请参阅

RpcNsBindingLookupDone

RpcNsBindingLookupNext