FsRtlDeleteKeyFromTunnelCache function (ntifs.h)

The FsRtlDeleteKeyFromTunnelCache routine deletes any tunnel cache entries for files in a directory that is being deleted.

Syntax

void FsRtlDeleteKeyFromTunnelCache(
  [in] TUNNEL    *Cache,
       ULONGLONG DirectoryKey
);

Parameters

[in] Cache

A pointer to a tunnel cache that was initialized by FsRtlInitializeTunnelCache.

DirectoryKey

The directory key value for the directory that is being removed. For more information, see the reference entry for FsRtlInitializeTunnelCache.

Return value

None

Remarks

File systems call FsRtlDeleteKeyFromTunnelCache when deleting a directory from a volume. FsRtlDeleteKeyFromTunnelCache deletes all tunnel cache entries whose directory keys match the value specified in the DirKey parameter.

To delete the tunnel cache, use FsRtlDeleteTunnelCache.

The caller is required to synchronize this call against FsRtlDeleteTunnelCache. In other words, a file system must ensure that it does not call FsRtlDeleteKeyFromTunnelCache and FsRtlDeleteTunnelCache at the same time from different threads.

For more information about file name tunneling, see Microsoft Knowledge Base Article 172190.

Requirements

Requirement Value
Minimum supported client Windows 2000
Target Platform Universal
Header ntifs.h (include FltKernel.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

FsRtlDeleteTunnelCache

FsRtlInitializeTunnelCache