◄Function Group► ◄Overview► ◄Up► ◄Next► ◄Previous► ──────────────────────────────────────────────────────────────────────────── #define INCL_DOSFILEMGR USHORT DosSetFileMode(pszFileName, usAttribute, ulReserved) PSZ pszFileName; /* filename */ USHORT usAttribute; /* new file attribute */ ULONG ulReserved; /* must be zero */ The DosSetFileMode function sets the file attributes of the specified file. A file's mode is defined by the settings of its attributes. The DosSetFileMode function is a family API function. Parameter Description ──────────────────────────────────────────────────────────────────────────── pszFileName Points to a null-terminated string that specifies the name of the file. The string must be a valid MS OS/2 filename. usAttribute Specifies the file's new attributes. This parameter can be a combination of the following values: Value Meaning ─────────────────────────────────────────────────────────────── FILE_NORMAL File can be read from or written to. FILE_READONLY File can be read from but not written to. FILE_HIDDEN File is hidden and does not appear when a directory is listed. FILE_SYSTEM File is a system file. FILE_ARCHIVED File has been archived. The FILE_NORMAL value can be combined only with the FILE_ARCHIVED value. ulReserved Specifies a reserved value; must be zero. Return Value The return value is zero if the function is successful. Otherwise, it is an error value, which may be one of the following: ERROR_ACCESS_DENIED ERROR_DRIVE_LOCKED ERROR_FILE_NOT_FOUND ERROR_NOT_DOS_DISK ERROR_PATH_NOT_FOUND ERROR_SHARING_BUFFER_EXCEEDED ERROR_SHARING_VIOLATION See Also DosQFileMode ♦