Sets a maximum for the number of simultaneously open files at the stdio level.
int _setmaxstdio( int newmax );
| Routine | Required Header | Compatibility |
| _setmaxstdio | <stdio.h> | Win 95, Win NT |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
| LIBC.LIB | Single thread static library, retail version |
| LIBCMT.LIB | Multithread static library, retail version |
| MSVCRT.LIB | Import library for MSVCRT.DLL, retail version |
Return Value
Returns newmax if successful; –1 otherwise.
Parameter
newmax
New maximum for number of simultaneously open files at the stdio level
Remarks
The _setmaxstdio function changes the maximum value for the number of files which may be simultaneously open at the stdio level.
C run-time I/O now supports many more open files on Win32 platforms than in previous versions. Up to 2,048 files may be open simultaneously at the lowio level (that is, opened and accessed by means of the _open, _read, _write, and so forth family of I/O functions). Up to 512 files may be open simultaneously at the stdio level (that is, opened and accessed by means of the fopen, fgetc, fputc, and so forth family of functions). The limit of 512 open files at the stdio level may be increased to a maximum of 2,048 by means of the _setmaxstdio function.
Since stdio level functions, such as fopen, are built on top of the lowio functions, the maximum of 2,048 is a hard upper limit for the number of simultaneously open files accessed through the C run-time library.
Note This upper limit may be beyond what is supported by a particular Win32 platform and configuration.