Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic


Extended ISAM file creation routine.

Short Name



Extended ISAM function


COUNT CreateISAMXtd(pTEXT filnam, COUNT userprof, pTEXT userid, pTEXT userword,

pTEXT servname, LONG permmask, pTEXT groupid, pTEXT fileword)


CreateISAMXtd() is a variation of CreateISAM() that permits the use of the FairCom Server’s security system. This section expands on the description of CreateISAM().

userprof is the user profile mask. Setting this to the value USERPRF_NTKEY disables the automatic TransformKey() feature. See the TransformKey() function description for more information. Setting this to the value USERPRF_SAVENV enables the automatic ctSAVENV feature. See the Begin() function description for more information. You can OR these values together, or leave userprof set to zero if you don’t want either.

userid is a pointer to a buffer containing the user ID. If userid is null, the user is assigned the ID of GUEST

userword is a pointer to a buffer containing the user password.

servname is a pointer to a Server name if you are going to use a Server other than the default Server.

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 user IDs, user passwords, server names, permission masks, group IDs, and file passwords, review Security and Encryption (File Security and Encryption, /doc/ctreeplus/FileSecurityandEncryption.htm).


The following error codes may be seen in addition to those for CreateISAM():


Symbolic Constant




Invalid user ID.



Invalid user password.



Invalid Server name.



This user does not belong to the group groupid.

See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.

See also

CreateISAM, TransformKey, Begin, InitISAM, OpenISAM, CloseISAM