Función RpcNsMgmtInqExpAge (rpcnsi.h)

La función RpcNsMgmtInqExpAge devuelve la antigüedad de expiración global para las copias locales de los datos del servicio de nombres.

Nota Esta función no se admite en Windows Vista ni en sistemas operativos posteriores.

 

Sintaxis

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

Parámetros

ExpirationAge

Puntero a la antigüedad de expiración predeterminada, en segundos. Este valor lo usan todas las operaciones de servicio de nombre siguiente.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.

 

Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.

 

Comentarios

La función RpcNsMgmtInqExpAge devuelve la antigüedad de expiración que usa la aplicación. La antigüedad de expiración es la cantidad de tiempo en segundos que puede existir una copia local de datos de un atributo name-service antes de que una solicitud de la aplicación para el atributo requiera actualizar la copia local. Cuando una aplicación comienza a ejecutarse, la biblioteca en tiempo de ejecución rpc especifica una antigüedad de expiración predeterminada de dos horas. El valor predeterminado es global para la aplicación.

Las siguientes operaciones de puntero usan una antigüedad de expiración (que lee datos de atributos de servicio de nombres). Normalmente, una operación siguiente se inicia buscando una copia local de los datos de atributo solicitados por una aplicación. En ausencia de una copia local, la siguiente operación crea uno con datos de atributo nuevos de la base de datos name-service. Si ya existe una copia local, la operación compara su antigüedad real con la edad de expiración que usa la aplicación. Si la antigüedad real supera la antigüedad de expiración, la operación intenta actualizar automáticamente la copia local con datos de atributo nuevos. Si la actualización es imposible, los datos locales antiguos permanecen en su lugar y se produce un error en la siguiente operación.

Normalmente, las aplicaciones solo deben usar la antigüedad de expiración predeterminada. Sin embargo, en el caso especial, una aplicación puede sustituir una antigüedad global de expiración proporcionada por el usuario para el valor predeterminado mediante una llamada a RpcNsMgmtSetExpAge. La función RpcNsMgmtInqExpAge devuelve la antigüedad de expiración global actual, ya sea un valor predeterminado o proporcionado por el usuario. Una aplicación también puede invalidar temporalmente la antigüedad de expiración global mediante una llamada a la función RpcNsMgmtHandleSetExpAge .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcnsi.h (incluir Rpc.h)
Library	Rpcns4.lib
Archivo DLL	Rpcns4.dll

Consulte también

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge