2.1.1.2 Per TunnelCacheEntry

Implementation of tunnel caching is optional.<10> If case-sensitive file name matching is enabled (for example, for POSIX compliance), the object store SHOULD NOT implement tunnel caching. If the object store implements tunnel caching, it MUST implement the following attributes in each TunnelCacheEntry:

  • EntryTime: The time at which this TunnelCacheEntry was created. The object store SHOULD use this attribute to automatically purge this entry from the tunnel cache once the entry is 15 seconds old.

  • ParentFile: The parent DirectoryFile that this TunnelCacheEntry refers to.

  • FileName: A Unicode string specifying the long name of the file. This string MUST be greater than 0 characters and less than 256 characters in length. Valid characters for a file name are specified in [MS-FSCC] section 2.1.5.

  • FileShortName: A Unicode string specifying the short name of the file. If KeyByShortName is FALSE, this string could be empty. If the string is not empty, it MUST be 8.3-compliant as described in [MS-FSCC] section 2.1.5.2.1.

  • KeyByShortName: A Boolean that is TRUE when FileShortName is used as the key for this entry. FALSE when FileName is used as the key for this entry.

  • FileCreationTime: The time that identifies when the file was created in the FILETIME format specified in [MS-FSCC] section 2.1.1.

  • ObjectIdInfo: A FILE_OBJECTID_INFORMATION structure (as specified in [MS-FSCC] section 2.4.28.1) that specifies the object ID information of the file at the time this TunnelCacheEntry was created.

Show: