Fonction RpcNsMgmtSetExpAge (rpcnsi.h)
La fonction RpcNsMgmtSetExpAge modifie l’âge d’expiration global de l’application pour les copies locales des données de name-service.
Syntaxe
RPC_STATUS RpcNsMgmtSetExpAge(
unsigned long ExpirationAge
);
Paramètres
ExpirationAge
Pointeur vers l’âge d’expiration par défaut, en secondes. Cette valeur est utilisée par toutes les opérations de service de nom-suivant. Un âge d’expiration de 0 entraîne une mise à jour immédiate des données de service de nom local.
Pour réinitialiser l’âge d’expiration à une valeur par défaut affectée par RPC de deux heures, spécifiez une valeur de RPC_C_NS_DEFAULT_EXP_AGE.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
Nom de service indisponible. |
Notes
La fonction RpcNsMgmtSetExpAge modifie l’âge d’expiration global d’une application. L’âge d’expiration est la durée pendant laquelle une copie locale de données à partir d’un attribut name-service peut exister avant qu’une demande de l’application pour l’attribut nécessite la mise à jour de la copie locale. Lorsqu’une application commence à s’exécuter, la bibliothèque d’exécution RPC spécifie une durée d’expiration par défaut de deux heures. La valeur par défaut est globale pour l’application. En règle générale, vous devez éviter d’utiliser RpcNsMgmtSetExpAge. Au lieu de cela, vous devez vous fier à l’âge d’expiration par défaut.
Un âge d’expiration est utilisé par les opérations de pointeur suivant (qui lisent les données des attributs name-service). Une opération suivante commence généralement par rechercher une copie locale des données d’attribut demandées par une application. En l’absence d’une copie locale, l’opération suivante en crée une avec de nouvelles données d’attribut à partir de la base de données name-service. Si une copie locale existe déjà, l’opération compare son âge réel à l’âge d’expiration utilisé par l’application. Si l’âge réel dépasse l’âge d’expiration, l’opération tente automatiquement de mettre à jour la copie locale avec de nouvelles données d’attribut. Si la mise à jour est impossible, les anciennes données locales restent en place et l’opération suivante échoue, renvoyant le code RPC_S_NAME_SERVICE_UNAVAILABLE status.
Si vous définissez l’âge d’expiration sur une petite valeur, les opérations suivantes du pointeur mettent à jour fréquemment les données locales pour tous les attributs nom-service demandés par votre application. Par exemple, la définition de l’âge d’expiration sur 0 force toutes les opérations suivantes à mettre à jour les données locales pour l’attribut name-service demandé par votre application. Par conséquent, la définition de petits âges d’expiration peut créer des problèmes de performances pour votre application et augmenter le trafic réseau. En outre, si votre application utilise un serveur de service de noms distant, un petit âge d’expiration peut nuire aux performances réseau de toutes les applications.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rpcnsi.h (inclure Rpc.h) |
| Bibliothèque | Rpcns4.lib |
| DLL | Rpcns4.dll |