Extended data file creation.
Low-Level data file function
COUNT CreateDataFileXtd(FILNO datno, pTEXT filnam,
UCOUNT datlen, UCOUNT xtdsiz, COUNT filmod,
LONG permmask, pTEXT groupid, pTEXT fileword)
In V12 the file number typedef was formally changed from COUNT, a two-byte value to FILNO, a four-byte value. Refer to this link for compatibility details. Four Byte File Numbering
CreateDataFileXtd() is a variation of CreateDataFile() that permits the use of the FairCom Server’s security system. This section expands on the description of CreateDataFile().
permmask is the permission mask assigned to this data file. It is formed by OR-ing the appropriate permission constants.
groupid is a pointer to a buffer that contains the group id that this file is to be assigned to. The group id must be valid for the user that is creating the file. If groupid is null, the file will be assigned to the default group for the user.
fileword is an optional file password. If fileword is null then there will be no password for this file. If a password is established, every user will need to use the password to be able to open the file.
The following error code may be seen in addition to those for CreateDataFile():
This user does not belong to the group groupid.
See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.
InitCTree, CreateIndexFile, CreateDataFile