Funzione RpcNsMgmtSetExpAge (rpcnsi.h)
La funzione RpcNsMgmtSetExpAge modifica l'età di scadenza globale dell'applicazione per le copie locali dei dati name-service.
Sintassi
RPC_STATUS RpcNsMgmtSetExpAge(
unsigned long ExpirationAge
);
Parametri
ExpirationAge
Puntatore all'età di scadenza predefinita, in secondi. Questo valore viene usato da tutte le operazioni del servizio nome-next. Un'età di scadenza pari a 0 causa un aggiornamento immediato dei dati del servizio nome locale.
Per reimpostare l'età di scadenza in un valore predefinito assegnato da RPC di due ore, specificare un valore di RPC_C_NS_DEFAULT_EXP_AGE.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
Il servizio nome non è disponibile. |
Commenti
La funzione RpcNsMgmtSetExpAge modifica l'età di scadenza globale di un'applicazione. L'età di scadenza è la quantità di tempo in cui può esistere una copia locale di dati da un attributo name-service prima che una richiesta dell'applicazione per l'attributo richieda l'aggiornamento della copia locale. Quando un'applicazione inizia l'esecuzione, la libreria di runtime RPC specifica un'età di scadenza predefinita di due ore. Il valore predefinito è globale per l'applicazione. In genere, è consigliabile evitare di usare RpcNsMgmtSetExpAge. È invece consigliabile basarsi sull'età di scadenza predefinita.
Un'età di scadenza viene usata dalle operazioni successive di Puntatore (che legge i dati dagli attributi del servizio nome). Un'operazione successiva viene in genere avviata cercando una copia locale dei dati dell'attributo richiesti da un'applicazione. In assenza di una copia locale, l'operazione successiva crea una con i dati dell'attributo fresco dal database name-service. Se esiste già una copia locale, l'operazione confronta l'età effettiva con l'età di scadenza usata dall'applicazione. Se l'età effettiva supera l'età di scadenza, l'operazione tenta automaticamente di aggiornare la copia locale con i dati dell'attributo fresco. Se l'aggiornamento è impossibile, i dati locali precedenti rimangono sul posto e l'operazione successiva ha esito negativo, restituendo il codice di stato RPC_S_NAME_SERVICE_UNAVAILABLE.
L'impostazione dell'età di scadenza su un valore ridotto causa l'aggiornamento frequente dei dati locali per qualsiasi attributo name-service richiesto dall'applicazione. Ad esempio, l'impostazione dell'età di scadenza su 0 impone a tutte le operazioni successive di aggiornare i dati locali per l'attributo name-service richiesto dall'applicazione. Pertanto, l'impostazione di piccole età di scadenza può creare problemi di prestazioni per l'applicazione e aumentare il traffico di rete. Inoltre, se l'applicazione usa un server di nome remoto, una piccola età di scadenza può influire negativamente sulle prestazioni di rete per tutte le applicazioni.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcnsi.h (include Rpc.h) |
| Libreria | Rpcns4.lib |
| DLL | Rpcns4.dll |