rpcNsMgmtInqExpAge 函数 (rpcnsi.h)

  • 项目

RpcNsMgmtInqExpAge 函数返回名称服务数据的本地副本的全局过期期限。

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

语法

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

参数

ExpirationAge

指向默认过期期限（以秒为单位）的指针。 此值由所有名称服务后续操作使用。

返回值

值 含义
RPC_S_OK
 调用成功。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

RpcNsMgmtInqExpAge 函数返回应用程序使用的过期期限。 过期期限是名称服务属性的本地数据副本在应用程序对属性的请求需要更新本地副本之前可以存在的时间（以秒为单位）。 当应用程序开始运行时，RPC 运行时库将默认过期期限指定为 2 小时。 对于应用程序，默认值为全局。

“下一个指针”操作使用过期期限， (从名称服务属性) 读取数据。 下一个操作通常从查找应用程序请求的属性数据的本地副本开始。 在没有本地副本的情况下，下一个操作将创建一个具有来自名称服务数据库的全新属性数据。 如果本地副本已存在，该操作会将其实际使用期限与应用程序使用的过期期限进行比较。 如果实际期限超过过期期限，该操作会自动尝试使用新的属性数据更新本地副本。 如果无法更新，旧本地数据将保留到位，下一个操作将失败。

应用程序通常应仅使用默认过期期限。 但是，对于特殊情况，应用程序可以通过调用 RpcNsMgmtSetExpAge 替换用户提供的全局过期期限作为默认值。 RpcNsMgmtInqExpAge 函数返回当前全局过期期限，无论是默认值还是用户提供的值。 应用程序还可以通过调用 RpcNsMgmtHandleSetExpAge 函数暂时替代全局过期期限。

要求

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

另请参阅

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge