OpenCtFileXtd

Extended data or index file open.

Short Name

OPNFILX()

Type

Extended low-level file function

Declaration

COUNT OpenCtFileXtd(COUNT filno, pTEXT filnam, COUNT filmod, pTEXT fileword)

Description

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

fileword is an optional file password. Set fileword to NULL if there is 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.

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 OpenCtFile():

Value	Symbolic Constant	Explanation
456	SACS_ERR	This user does not belong to a group that can access this file.
457	SPWD_ERR	Invalid password.

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