C API Reference -- Ns_RollFile

### Ns_RollFile

#### Overview

Rename a file and increment its backup number

#### Syntax

        int Ns_RollFile(
        char *filename,
        int backupMax
        );

#### Description

The Ns_RollFile function renames the specified file, incrementing its backup number (file extension). The `backupMax` argument must be between 1 and 1000. Ns_RollFile returns a status of NS_ERROR or NS_OK.

Top of Page
Copyright © 1998-99 America Online, Inc.