FairCom ISAM for C

CreateIFileXtd

Extended incremental ISAM creation.

Short Name

CREIFILX()

Type

Extended ISAM function

Declaration

COUNT CreateIFileXtd(pIFIL ifilptr, cpTEXT dataextn,

cpTEXT indxextn, LONG permmask,

cpTEXT groupid, cpTEXT fileword)

Description

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

dataextn and indxextn point to buffers specifying the data and index file name extensions, respectively, which should include the period, ‘.’. The extensions are 8-byte ASCIIZ (NULL terminated ASCII) strings. If the pointers are NULL, the default extension will be used: “.dat” for data files and “.idx” for index files. For files with no extension, pass a pointer to a buffer that contains only blanks terminated by a NULL character.

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

Return

The following error code may be seen in addition to those for CreateIFile():

Value	Symbolic Constant	Explanation
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.