Funzione FsRtlAddToTunnelCache (ntifs.h)

Articolo
12/21/2024

La routine FsRtlAddToTunnelCache memorizza nella cache un nome di file rimosso da una directory quando un file viene rinominato o eliminato.

Sintassi

void FsRtlAddToTunnelCache(
  [in] TUNNEL         *Cache,
  [in] ULONGLONG      DirectoryKey,
  [in] UNICODE_STRING *ShortName,
  [in] UNICODE_STRING *LongName,
  [in] BOOLEAN        KeyByShortName,
  [in] ULONG          DataLength,
  [in] VOID           *Data
);

Parametri

[in] Cache

Puntatore a una cache del tunnel inizializzata da FsRtlInitializeTunnelCache.

[in] DirectoryKey

Valore chiave della directory contenente il file che viene eliminato o rinominato. La chiave di directory è un identificatore univoco a 64 bit non firmato generato e assegnato alla directory dal file system.

[in] ShortName

Stringa Unicode contenente il nome breve (8.3) per il file. Se KeyByShortName è FALSE, ShortName è facoltativo.

[in] LongName

Stringa Unicode contenente il nome lungo per il file. Un nome di file lungo è un nome per un file o una directory che supera il formato del nome file standard 8.3. Se KeyByShortName è TRUE, LongName è facoltativo.

[in] KeyByShortName

Impostare su true se il nome del file da eliminare dalla directory è il nome breve del file, FALSE se è il nome lungo.

[in] DataLength

Lunghezza in byte delle informazioni da archiviare nella voce della cache del tunnel per questo file. Il valore di questo parametro è specifico del file system, ma deve essere lo stesso per tutte le voci nella cache del tunnel.

[in] Data

Puntatore a un buffer che contiene informazioni specifiche del file system da archiviare nella voce della cache del tunnel per questo file.

Valore restituito

Nessuno

Osservazioni

Quando un nome file viene rimosso da una directory (per un file rinominato o eliminato), il file system può memorizzare nella cache il nome del file chiamando FsRtlAddToTunnelCache. Lo scopo della cache del tunnel è propagare le proprietà del file se viene creato un nuovo file con lo stesso nome lungo o breve del file appena eliminato o rinominato.

FsRtlAddToTunnelCache crea una nuova voce contenente il nome file e la chiave di directory specificati e aggiunge la voce alla cache del tunnel per il volume montato in cui il file viene rimosso o eliminato. Questa voce può contenere anche un pacchetto di dati a dimensione fissa di informazioni specifiche del file system per il file.

Il chiamante è necessario per sincronizzare questa chiamata con FsRtlDeleteTunnelCache. In altre parole, un file system deve assicurarsi che non chiami FsRtlAddToTunnelCache e FsRtlDeleteTunnelCache contemporaneamente da thread diversi.

Per altre informazioni sul tunneling dei nomi file, vedere articolo della Microsoft Knowledge Base 172190.