On Time RTOS-32 Documentation
Welcome
RTTarget-32
RTKernel-32
RTFiles-32
RTFiles-32 Programming Manual
RTFiles-32 Reference Manual
Introduction
General File I/O
Information about Files
File Attributes
Directories
Finding Files
File Name Operations
Disk and Volume Management
Miscellaneous File Functions
Raw I/O Functions
Functions for Debugging
Device Dependent Functions
Obsolete Functions
Disk Device Driver API
MTD Device Driver API
RTFiles-32 Error Codes
Code Page Reference
RTIP-32
RTPEG-32
RTUSB-32
|
Introduction
All functions documented here are declared in header file Rtfiles.h and are included in library Rtfiles.lib.
Most RTFiles-32 functions return an integer value. If the documentation for the respective function does not explicitly state something different, negative return values indicate an error. Section RTFiles-32 Error Codes lists all possible error return codes. Values greater than or equal to 0 (constant RTF_NO_ERROR) indicate success. The meaning of positive return values is documented for each function.
Rtfiles.h defines type RTFHANDLE, which is an integer. RTFOpen and RTFFindFirstEx return values of this type. Such values are file handles (if greater than or equal to 0) or error codes if less than 0. File handles can be used in subsequent RTFiles-32 API calls to reference an open file. Handles returned by RTFFindFirstEx are actually file handles for a directory. Care must be taken to close all file handles to ensure that all data is flushed to the disk and subsequent RTFOpen calls will not fail because the number of available file handles is exhausted.
General File I/O
|