_setmaxstdio_setmaxstdio

스트림 I/O 수준에서 동시에 열려 있는 파일 수의 최댓값을 설정합니다.Sets a maximum for the number of simultaneously open files at the stream I/O level.

구문Syntax

int _setmaxstdio(
   int new_max
);

매개 변수Parameters

new_maxnew_max
스트림 I/O 수준에서 동시에 열려 있는 파일 수에 대한 새로운 최댓값.New maximum for the number of simultaneously open files at the stream I/O level.

반환 값Return Value

정상적으로 실행되면 new_max를 반환하고, 그렇지 않으면 -1을 반환합니다.Returns new_max if successful; -1 otherwise.

new_max_IOB_ENTRIES보다 작거나 운영 체제에서 사용 가능한 최대 핸들 수보다 많으면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다.If new_max is less than _IOB_ENTRIES, or greater than the maximum number of handles available in the operating system, the invalid parameter handler is invoked, as described in Parameter Validation. 계속해서 실행하도록 허용된 경우 이 함수는 -1을 반환하고 errnoEINVAL로 설정합니다.If execution is allowed to continue, this function returns -1 and sets errno to EINVAL.

이 오류 및 다른 오류 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr을 참조하세요.For information about these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

설명Remarks

_setmaxstdio 함수는 스트림 I/O 수준에서 동시에 열 수 있는 파일 수의 최댓값을 변경합니다.The _setmaxstdio function changes the maximum value for the number of files that may be open simultaneously at the stream I/O level.

C 런타임 I/O는 이제 낮은 I/O 수준에서 동시에 열리는 최대 8,192개의 파일을 지원합니다.C run-time I/O now supports up to 8,192 files open simultaneously at the low I/O level. 이 수준에는 I/O 함수의 _open, _read_write 패밀리를 사용하여 열고 액세스하는 파일이 포함됩니다.This level includes files opened and accessed using the _open, _read, and _write family of I/O functions. 기본적으로 스트림 I/O 수준에서 최대 512개의 파일을 동시에 열 수 있습니다.By default, up to 512 files can be open simultaneously at the stream I/O level. 이 수준에는 함수의 fopen, fgetcfputc 패밀리를 사용하여 열고 액세스하는 파일이 포함됩니다.This level includes files opened and accessed using the fopen, fgetc, and fputc family of functions. 스트림 I/O 수준에서 열 수 있는 파일 수에 대한 제한(512개)은 _setmaxstdio 함수를 사용하여 최대 8,192개까지 늘릴 수 있습니다.The limit of 512 open files at the stream I/O level can be increased to a maximum of 8,192 by use of the _setmaxstdio function.

fopen과 같은 스트림 I/O 수준 함수는 낮은 I/O 함수를 기반으로 빌드되므로 최댓값 8,192는 C 런타임 라이브러리를 통해 액세스하는 동시에 열 수 있는 파일 수에 대한 하드 상한입니다.Because stream I/O-level functions, such as fopen, are built on top of the low I/O-level functions, the maximum of 8,192 is a hard upper limit for the number of simultaneously open files accessed through the C run-time library.

참고

이 상한은 특정 Win32 플랫폼 및 구성에서 지원하는 수를 초과할 수 있습니다.This upper limit might be beyond what's supported by a particular Win32 platform and configuration.

요구 사항Requirements

루틴에서 반환된 값Routine 필수 헤더Required header
_setmaxstdio_setmaxstdio <stdio.h><stdio.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.For more compatibility information, see Compatibility.

예제Example

_setmaxstdio를 사용하는 예제는 _getmaxstdio를 참조하세요.See _getmaxstdio for an example of using _setmaxstdio.

참고자료See also

스트림 I/OStream I/O