PutIFileXtd

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

Short Name

PUTIFILX()

Type

Extended ISAM function

Declaration

COUNT PutIFileXtd(pIFIL ifilptr, pTEXT dataextn,

                  pTEXT indxextn, pTEXT fileword)

Description

PutIFileXtd() is a variation of PutIFile() that permits the use of the c-tree 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” in the c-tree Plus 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.

Return

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

Value	Symbolic Constant	Explanation
455	SGRP_ERR	This user does not belong to the group groupid.

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

Limitations

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