|
|
|
OpenCtFileXtd
Extended data or index file open.
Short Name
OPNFILX()
Type
Extended Low-Level file function
Declaration
COUNT OpenCtFileXtd(FILNO filno, pTEXT filnam, COUNT filmod, pTEXT fileword)
Description
In V12 the file number typedef was formally changed from COUNT, a two-byte value to FILNO, a four-byte value. Refer to this link for compatibility details. Four Byte File Numbering
OpenCtFileXtd() is a variation of OpenCtFile() that permits the use of the FairCom 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 (File Security and Encryption, /doc/ctreeplus/FileSecurityandEncryption.htm) in the c-tree 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. |
775 |
UNQK_ERR |
No UNQKEY support for REPLICATION. If a Low-Level file open call that requests write access to a c-tree data file fails with this error, it is because the data file has replication enabled. A c-tree data file that has replication enabled can only be opened for write access at the ISAM level. A read-only Low-Level call is allowed: use the ctREADFIL | ctSHARED filemodes when opening the file in addition to the other filemode options that you are using. |
See c-tree Error Codes for a complete listing of valid c-tree error values.
See also
InitCTree(), CreateIndexFile(), OpenCtFile()
