Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

RebuildIFileXtd

Extended Incremental ISAM rebuild.

Short Name

RBLIFILX()

Type

Extended ISAM function

Declaration

COUNT RebuildIFileXtd(pIFIL ifilptr, pTEXT dataextn, pTEXT indxextn,

LONG permmask, pTEXT groupid, pTEXT fileword)

Description

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

  • dataextn and indxextn point to buffers specifying optional data and index file name extensions, respectively. The extensions are 8-byte ASCIIZ strings. If the pointers are NULL, the default extension are used: .dat for data files and .idx for index files. To use no extensions, pass a pointer to a buffer containing only blanks terminated by NULL. Do not set both extensions to blanks. The data and index files must be distinct.
  • permmask is the permission mask assigned to this data file. It is formed by OR-ing the appropriate permission constants.
  • groupid is a pointer to a buffer that contains the group id that this file is to be assigned to. The group id must be valid for the user that is creating the file. If groupid is null, the file will be assigned to the default group for the user.
  • 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 (File Security and Encryption, /doc/ctreeplus/FileSecurityandEncryption.htm) in the c-tree Programmer’s Reference Guide.

Return

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

Value

Symbolic Constant

Explanation

455

SGRP_ERR

This user does not belong to the group groupid.

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

See also

TOCIndex