Previous

Next

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