Función RpcNsMgmtSetExpAge (rpcnsi.h)

La función RpcNsMgmtSetExpAge modifica la antigüedad global de expiración de la aplicación 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 RpcNsMgmtSetExpAge(
  unsigned long ExpirationAge
);

Parámetros

ExpirationAge

Puntero a la antigüedad de expiración predeterminada, en segundos. Todas las operaciones de nombre service–next usan este valor. Una antigüedad de expiración de 0 provoca una actualización inmediata de los datos del servicio de nombres locales.

Para restablecer la antigüedad de expiración a un valor predeterminado asignado por RPC de dos horas, especifique un valor de RPC_C_NS_DEFAULT_EXP_AGE.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_NAME_SERVICE_UNAVAILABLE	El nombre del servicio no está disponible.

 

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

 

Comentarios

La función RpcNsMgmtSetExpAge modifica la edad de expiración global de una aplicación. La antigüedad de expiración es la cantidad de tiempo 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. Normalmente, debe evitar el uso de RpcNsMgmtSetExpAge. En su lugar, debe confiar en la antigüedad de expiración predeterminada.

Las siguientes operaciones de puntero usan una antigüedad de expiración (que lee datos de atributos de nombre-servicio). Normalmente, se inicia una siguiente operación 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 una 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 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, devolviendo el código de estado de RPC_S_NAME_SERVICE_UNAVAILABLE.

Al establecer la antigüedad de expiración en un valor pequeño, las siguientes operaciones de puntero actualizan con frecuencia los datos locales para cualquier atributo de servicio de nombre solicitado por la aplicación. Por ejemplo, al establecer la edad de expiración en 0, se obliga a todas las operaciones siguientes a actualizar los datos locales para el atributo name-service solicitado por la aplicación. Por lo tanto, establecer pequeñas edades de expiración puede crear problemas de rendimiento para la aplicación y aumentar el tráfico de red. Además, si la aplicación usa un servidor de servicio de nombres remoto, una edad de expiración pequeña puede afectar negativamente al rendimiento de red para todas las aplicaciones.

Requisitos

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 (incluya Rpc.h)
Library	Rpcns4.lib
Archivo DLL	Rpcns4.dll

Consulte también

RpcNsMgmtHandleSetExpAge