FsRtlAddToTunnelCache, fonction (ntifs.h)

Article
12/21/2024

Le FsRtlAddToTunnelCache routine met en cache un nom de fichier supprimé d’un répertoire lorsqu’un fichier est renommé ou supprimé.

Syntaxe

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
);

Paramètres

[in] Cache

Pointeur vers un cache de tunnel initialisé par FsRtlInitializeTunnelCache.

[in] DirectoryKey

Valeur de clé du répertoire contenant le fichier en cours de suppression ou de renommage. La clé de répertoire est un identificateur 64 bits non signé unique généré et affecté au répertoire par le système de fichiers.

[in] ShortName

Chaîne Unicode contenant le nom court (8.3) du fichier. Si KeyByShortName est FALSE, ShortName est facultatif.

[in] LongName

Chaîne Unicode contenant le nom long du fichier. Un nom de fichier long est un nom pour un fichier ou un répertoire qui dépasse le format de nom de fichier 8.3 standard. Si KeyByShortName est TRUE, LongName est facultatif.

[in] KeyByShortName

Défini sur TRUE si le nom de fichier à supprimer du répertoire est le nom court du fichier, FALSE s’il s’agit du nom long.

[in] DataLength

Longueur en octets des informations à stocker dans l’entrée du cache de tunnel pour ce fichier. La valeur de ce paramètre est spécifique au système de fichiers, mais elle doit être la même pour toutes les entrées dans le cache de tunnel.

[in] Data

Pointeur vers une mémoire tampon qui contient des informations spécifiques au système de fichiers à stocker dans l’entrée du cache de tunnel pour ce fichier.

Valeur de retour

Aucun

Remarques

Lorsqu’un nom de fichier est supprimé d’un répertoire (pour un fichier renommé ou supprimé), le système de fichiers peut mettre en cache le nom du fichier en appelant FsRtlAddToTunnelCache. L’objectif du cache de tunnel est de propager les propriétés de fichier si un nouveau fichier est créé qui a le même nom long ou court que le fichier juste supprimé ou renommé.

FsRtlAddToTunnelCache crée une entrée qui contient le nom de fichier et la clé de répertoire spécifiés, puis ajoute l’entrée au cache de tunnel pour le volume monté où le fichier est supprimé ou supprimé. Cette entrée peut également contenir un paquet de données de taille fixe d’informations spécifiques au système de fichiers pour le fichier.

L’appelant doit synchroniser cet appel avec FsRtlDeleteTunnelCache. En d’autres termes, un système de fichiers doit s’assurer qu’il n’appelle pas FsRtlAddToTunnelCache et FsRtlDeleteTunnelCache en même temps à partir de différents threads.

Pour plus d’informations sur le tunneling de noms de fichiers, consultez 'article 172190de la Base de connaissances Microsoft.