OpenIFileXtd

Extended Incremental ISAM open.

Short Name

OPNIFILX()

Type

Extended ISAM function

Declaration

COUNT OpenIFileXtd(pIFIL ifilptr, pTEXT dataextn,

                   pTEXT indxextn, pTEXT fileword)

Description

OpenIFileXtd() is a variation of OpenIFile() that permits the use of the c-tree Server’s security system. This section expands on the description of OpenIFile().

dataextn and indxextn point to buffers specifying the data and index file name extensions, respectively. 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.

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 id’s, and file passwords, review “Security and Encryption” in the c-tree Plus Programmer’s Reference Guide.

Note: This function supports EXCLUSIVE file opens. For more information, please refer to “Multi-user File Mode”.

Return

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

Value	Symbolic Constant	Explanation
456	SACS_ERR	User is not a member of a group with access to this file.
457	SPWD_ERR	Invalid password.

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