Funzione RpcNsMgmtInqExpAge (rpcnsi.h)
La funzione RpcNsMgmtInqExpAge restituisce l'età di scadenza globale per le copie locali dei dati name-service.
Sintassi
RPC_STATUS RpcNsMgmtInqExpAge(
unsigned long *ExpirationAge
);
Parametri
ExpirationAge
Puntatore all'età di scadenza predefinita, in secondi. Questo valore viene usato da tutte le operazioni successive del servizio dei nomi.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
Commenti
La funzione RpcNsMgmtInqExpAge restituisce l'età di scadenza usata dall'applicazione. L'età di scadenza è la quantità di tempo in secondi in cui può esistere una copia locale dei 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 una scadenza predefinita di due ore. Il valore predefinito è globale per l'applicazione.
Un'età di scadenza viene usata dalle operazioni successive del puntatore (che leggono i dati dagli attributi name-service). 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 ne crea una con i dati degli attributi aggiornati 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 aggiornati degli attributi. Se l'aggiornamento è impossibile, i dati locali precedenti rimangono sul posto e l'operazione successiva ha esito negativo.
Le applicazioni in genere devono usare solo l'età di scadenza predefinita. Per casi speciali, tuttavia, un'applicazione può sostituire un'età di scadenza globale fornita dall'utente per l'impostazione predefinita chiamando RpcNsMgmtSetExpAge. La funzione RpcNsMgmtInqExpAge restituisce l'età di scadenza globale corrente, ovvero un valore predefinito o fornito dall'utente. Un'applicazione può anche sostituire temporaneamente l'età di scadenza globale chiamando la funzione RpcNsMgmtHandleSetExpAge .
Requisiti
| Requisito | Valore |
|---|---|
| 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 |