F.39 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 c-tree 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 id's, user passwords, server names, 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 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 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

InitISAM, OpenISAM, and CloseISAM.