TestHugeFile

Test 8-byte file status.

Short Name

TESTHUGE()

Type

Low level function

Declaration

  COUNT TestHugeFile(COUNT filno)

Description

TestHugeFile() takes the file number of an opened file, filno, as its input argument to determine if the volume containing the file supports huge files.

Note: This function does NOT determine how much space is available, only if the OS logically supports such file sizes on the volume containing the open file referenced by filno.

Return

TestHugeFile() returns the following values:

Value	Symbolic Constant	Explanation
0	NO_ERROR	Files > 4 GB supported.
26	FACS_ERR	If filno is not in use.
-647	E2GB_COD	Files > 2 GB NOT supported.
-648	E4GB_COD	Files > 4 GB NOT supported.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.