<< Click to Display Table of Contents >> Navigation:  Structures >   strFileSpec Structure

 

Purpose

 

 

FileSpec Structure is used when creating files to describe the file.

 

 

 

Prototype

 

 

STRUCTURE strFileSpec ALIGN 1

 

 

 

Description

 

 

The filespec structure is used when creating files. See the Btrieve API documentation for more information about the possible values in this structure.

Note

Please be carefull when using this structure, to allocate enough memory for all of the KeySpec stuctures that you need

 

 

 

 

Source Code

 

 

STRUCTURE strFileSpec ALIGN 1

 MEMBER RecLen          AS WORD              // Record Length

 MEMBER PageSize        AS WORD              // Page size

 MEMBER IndxCnt         AS WORD              // # of indexes

 MEMBER Notused         AS DWORD            // (not used)

 MEMBER FileFlags       AS WORD              // File Flags

 MEMBER NumDuplPtr      AS BYTE              // # of duplicate pointers

 MEMBER Reserved        AS BYTE              // (not used)

 MEMBER Allocation      AS WORD

 MEMBER DIM KeyBuf[0]   IS strKeySpec        // Array of key definitions

 

 

 

 

 

See Also

 

 

_BTCreate(), strKeySpec, strStatFileSpecs

 

 

 

 

Notes

 

 

The FileFlags field can contain the following values:

Attribute                  Binary              Hex        Dec                VO Define

Variable Length                0000 0000 0001        01        1              BFF_VAR_RECS

Blank Truncation              0000 0000 0010        02        2              BFF_BLANK_TRUNC

Preallocation                  0000 0000 0100        04        4              BFF_PRE_ALLOC

Data Compression              0000 0000 1000        08        8              BFF_DATA_COMP

Key Only File                  0000 0001 0000        10        16              BFF_KEY_ONLY

Index Balanced File            0000 0010 0000        20        32              BFF_BALANCED_KEYS

10% Free Space                0000 0100 0000        40        64              BFF_FREE_10

20% Free Space                0000 1000 0000        80        128            BFF_FREE_20

30% Free Space                0000 1100 0000        C0        192            BFF_FREE_30

Duplicate Pointers            0001 0000 0000        100        256            BFF_DUP_PTRS

Reserved for future use        0010 0000 0000        200        512      

Key Number Specified          0100 0000 0000        400        1,024          BFF_SPEC_KEY_NUMS

VATs Used in File              1000 0000 0000        800        2048            BFF_VATS_SUPPORT