Funzione RxNameCacheActivateEntry (namcache.h)

Articolo
02/29/2024

RxNameCacheActivateEntry accetta una voce della cache dei nomi e aggiorna l'ora di scadenza e il contesto del mini-reindirizzamento di rete. Inserisce quindi la voce della cache dei nomi nell'elenco attivo.

Sintassi

void RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

Parametri

[in] NameCacheCtl

Puntatore alla struttura di NAME_CACHE_CONTROL in cui attivare la voce.

[in] NameCache

Puntatore alla struttura NAME_CACHE da attivare.

[in] LifeTime

Valore che indica la durata valida in secondi della voce della cache. Un valore pari a 0 significa lasciare invariato il valore corrente. Un valore pari a 0 viene usato per le reazioni dopo una corrispondenza in cui si vuole mantenere la durata originale.

[in] MRxContext

Valore del contesto fornito dal mini-redirector di rete per verificare l'uguaglianza durante l'esecuzione di un controllo di immissione valido. Un valore MRxContext pari a 0 significa lasciare invariato il valore corrente. Un valore pari a 0 viene usato per le reazioni dopo una corrispondenza in cui si vuole conservare l'oggetto MRxContext originale.

Valore restituito

nessuno

Osservazioni

La routine RxNameCacheActivateEntry viene normalmente chiamata dopo che un mini-reindirizzamento di rete chiama RxNameCacheCreateEntry per allocare e inizializzare una struttura NAME_CACHE con la stringa di nome specificata. Si prevede che il chiamante inizializzi eventuali elementi mini-reindirizzamento di rete aggiuntivi del contesto della cache dei nomi, ad esempio Durata (in secondi) e MRxContext e quindi inserisca la voce nell'elenco attivo della cache dei nomi chiamando RxNameCacheActivateEntry.

La routine RxNameCacheActivateEntry presuppone che la voce della cache dei nomi non sia presente nell'elenco gratuito o attivo.