Platform SDK: Files and I/O

IsReparseTagHighLatency

The IsReparseTagHighLatency macro determines whether a reparse point tag has its high-latency bit set, indicating a file or directory for which the operating system is expected to be slow to retrieve data.

ULONG IsReparseTagHighLatency(
  ULONG _tag  // tag to be tested
);

Parameters

_tag
Reparse point tag to be tested for high latency.

Return Values

The return value is a ULONG that must be treated as zero or nonzero. A nonzero return value means that the tag's high-latency bit is set. A zero return value means that the tag's high-latency bit is not set.

Remarks

If the tag has its high-latency bit set, expect the operating system to be slow to retrieve the first byte of file or directory data. An example of such a file is one residing on very slow mass storage. Your application should display some indication to users that retrieval is in progress.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winnt.h; include Windows.h.

See Also

File Systems Overview, File System Macros