Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <dos.h>
    unsigned _dos_setfileattr( char *path,
                               unsigned attributes );

Description:
    The _dos_setfileattr function uses system call 0x43 to set the
    attributes of the file or directory that path points to.  The possible
    attributes are:

    Attribute     Meaning

_A_NORMAL
    Indicates a normal file.  File can be read or written without any
    restrictions.

_A_RDONLY
    Indicates a read-only file.  File cannot be opened for "write".

_A_HIDDEN
    Indicates a hidden file.  This file will not show up in a normal
    directory search.

_A_SYSTEM
    Indicates a system file.  This file will not show up in a normal
    directory search.

_A_VOLID
    Indicates a volume-ID.

_A_SUBDIR
    Indicates a sub-directory.

_A_ARCH
    This is the archive flag.  It is set whenever the file is modified, and
    is cleared by the MS-DOS BACKUP command and other backup utility
    programs.


Returns:
    The _dos_setfileattr function returns zero if successful.  Otherwise, it
    returns an MS-DOS error code and sets  errno to one of the following:

    Constant     Meaning

ENOENT
    No file or directory matched the specified path.

EACCES
    Access denied; cannot change the volume ID or the subdirectory.


Example:
    #include <stdio.h>
    #include <dos.h>

    print_attribute()
      {
        unsigned attribute;

        _dos_getfileattr( "file", &attribute );
        printf( "File attribute is %x\n", attribute );
        if( attribute & _A_RDONLY ) {
            printf( "This is a read-only file\n" );
        } else {
            printf( "This is not a read-only file\n" );
        }
      }

    void main()
      {
        int      handle;

        if( _dos_creat( "file", _A_RDONLY, &handle ) != 0 ){
          printf( "Error creating file\n" );
        }
        print_attribute();
        _dos_setfileattr( "file", _A_NORMAL );
        print_attribute();
        _dos_close( handle );
      }

Classification:
    DOS

Systems:
    DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32, DOS/PM

See Also:
    _dos_getfileattr