FairCom ISAM for C

CreateISAMXtd

Extended ISAM file creation routine.

Short Name

CREISAMX()

Type

Extended ISAM function

Declaration

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

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

Description

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).

Return

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

Value	Symbolic Constant	Explanation
450	LUID_ERR	Invalid user ID.
451	LPWD_ERR	Invalid user password.
453	NSRV_ERR	Invalid Server name.
455	SGRP_ERR	This user does not belong to the group groupid.

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