RpcNsMgmtInqExpAge, fonction (rpcnsi.h)
La fonction RpcNsMgmtInqExpAge retourne l’âge d’expiration global pour les copies locales des données name-service.
Syntaxe
RPC_STATUS RpcNsMgmtInqExpAge(
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 suivantes du service de nom.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
Remarques
La fonction RpcNsMgmtInqExpAge retourne l’âge d’expiration utilisé par l’application. L’âge d’expiration est la durée en secondes 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.
Une ancienneté d’expiration est utilisée par les opérations de pointeur suivant (qui lisent les données des attributs nom-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.
Les applications doivent généralement utiliser uniquement l’âge d’expiration par défaut. Toutefois, dans des cas particuliers, une application peut remplacer l’âge d’expiration global fourni par l’utilisateur par la valeur par défaut en appelant RpcNsMgmtSetExpAge. La fonction RpcNsMgmtInqExpAge retourne l’âge d’expiration global actuel, qu’il s’agisse d’une valeur par défaut ou d’une valeur fournie par l’utilisateur. Une application peut également remplacer temporairement l’âge d’expiration global en appelant la fonction RpcNsMgmtHandleSetExpAge .
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |