RenameIFileXtd

Rename ISAM files, extended version.

Short Name

RENIFILX()

Type

Extended ISAM function

Declaration

COUNT RenameIFileXtd(pIFIL ifilptr, pTEXT dataextn, pTEXT indxextn)

Description

RenameIFileXtd() is a variation of RenameIFile() permitting the file extensions to be changed. This section expands on the description of RenameIFile().

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.

Return

As with RenameIFile(). See “c-tree Plus Error Codes” in the c-tree Plus Programmer’s Reference Guide for a complete listing of valid c-tree Plus error values.