Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic


Place an IFIL structure into a data file resource record. (Extended version)

Short Name



Extended ISAM function


COUNT PutIFileXtd(pIFIL ifilptr, pTEXT dataextn,

pTEXT indxextn, pTEXT fileword)


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

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 file passwords, review Security and Encryption (File Security and Encryption, /doc/ctreeplus/FileSecurityandEncryption.htm) in the c-tree Programmer’s Reference Guide.

dataextn and indxextn are pointers to buffers specifying optional data and index file name extensions, respectively. The extensions can be 8-byte ASCIIZ (NULL terminated ASCII) strings. If they are NULL pointers, 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. Do not set both extensions to blanks, since the index and data file names must be distinct.


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


Symbolic Constant




This user does not belong to the group groupid.

See c-tree Error Codes for a complete listing of valid c-tree error values.


The file must be closed prior to calling this function. PutIFile() opens the file in ctEXCLUSIVE mode and closes the file upon return.

See also