F.29 CreateDataFileXtd

---

Extended data file creation.

Short Name

CREDATX

TYPE

Low level data file function

DECLARATION

COUNT CreateDataFileXtd(COUNT datno, pTEXT filnam,

UCOUNT datlen, UCOUNT xtdsiz, COUNT filmod,

LONG permmask, pTEXT groupid, pTEXT fileword)

DESCRIPTION

CreateDataFileXtd is a variation of CreateDataFile that permits the use of the c-tree 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.

For more information on permission masks, group id's, and file passwords, review Chapter 12 "Security and Encryption" in the c-tree Plus Programmer's Reference Guide.

RETURN

The following error code may be seen in addition to those for CreateDataFile:

Value	Symbolic Constant	Explanation
455	SGRP_ERR	This user does not belong to the group groupid.

See Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus error values.

SEE ALSO

InitCTree, CreateIndexFile, and CreateDataFile.