tmpnam_s, _wtmpnam_s
임시 파일을 만드는 데 사용할 수 있는 이름을 생성합니다. 이러한 함수는 CRT의 보안 기능에 설명된 대로 향상된 보안 기능의 tmpnam 버전입니다_wtmpnam.
구문
errno_t tmpnam_s(
char * str,
size_t sizeInChars
);
errno_t _wtmpnam_s(
wchar_t *str,
size_t sizeInChars
);
template <size_t size>
errno_t tmpnam_s(
char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wtmpnam_s(
wchar_t (&str)[size]
); // C++ only
매개 변수
str
[out] 생성된 이름을 보유하는 포인터입니다.
sizeInChars
[in] 버퍼의 크기(문자)입니다.
반환 값
이 두 함수는 정상적으로 실행되면 0을 반환하고 오류 시에는 오류 번호를 반환합니다.
오류 조건
str |
sizeInChars |
반환 값 | str의 내용 |
|---|---|---|---|
NULL |
any | EINVAL |
수정 안 됨 |
NULL 아님(올바른 메모리를 가리킴) |
너무 짧음 | ERANGE |
수정 안 됨 |
검사점 생성 시 str 가 NULL인 경우 Parameter Validation를 참조하세요. 계속해서 실행하도록 허용된 경우 이러한 함수는 errno를 EINVAL로 설정하고 EINVAL을 반환합니다.
설명
이러한 각 함수는 현재 존재하지 않는 파일의 이름을 반환합니다. tmpnam_s 에서 반환한 지정된 Windows 임시 디렉터리에서 고유한 이름을 반환 GetTempPathW합니다. 파일 이름 앞에 백슬래시가 추가되고 경로 정보(예: \fname21경로 정보가 없는 경우)는 현재 작업 디렉터리에 이름이 유효하다는 것을 나타냅니다.
tmpnam_s의 경우에는 생성된 이 파일 이름을 str에 저장할 수 있습니다. tmpnam_s에서 반환하는 문자열의 최대 길이는 STDIO.H에 정의된 L_tmpnam_s입니다. str이 NULL이면 tmpnam_s은 결과를 내부 정적 버퍼에 유지합니다. 따라서 모든 후속 호출에서는 이 값을 제거합니다. 생성되는 tmpnam_s 이름은 프로그램에서 생성한 파일 이름과 첫 번째 호출 tmpnam_s후 STDIO의 경우 base 32(.1-.1vvvvvvu TMP_MAX_S )의 순차적 숫자의 파일 확장명으로 구성됩니다. H는 )입니다 INT_MAX.
tmpnam_s는 운영 체제에서 가져온 OEM 코드 페이지에 따라 멀티바이트 문자 시퀀스를 인식하여 멀티바이트 문자열 인수를 자동으로 적절히 처리합니다. _wtmpnam_s는 tmpnam_s의 와이드 문자 버전이고, _wtmpnam_s의 인수와 반환 값은 와이드 문자 문자열입니다. _wtmpnam_s 멀티 tmpnam_s 바이트 문자열을 _wtmpnam_s 처리하지 않는다는 점을 제외하고 동일하게 동작합니다.
C++에서는 템플릿 오버로드를 통해 이러한 함수를 사용하는 것이 더욱 간단해집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으므로 크기 인수를 지정할 필요가 없습니다. 자세한 내용은 안전한 템플릿 오버로드를 참조하세요.
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
일반 텍스트 루틴 매핑
| TCHAR.H 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
|---|---|---|---|
_ttmpnam_s |
tmpnam_s |
tmpnam_s |
_wtmpnam_s |
요구 사항
| 루틴에서 반환된 값 | 필수 헤더 |
|---|---|
tmpnam_s |
<stdio.h> |
_wtmpnam_s |
<stdio.h> 또는 <wchar.h> |
호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// crt_tmpnam_s.c
// This program uses tmpnam_s to create a unique filename in the
// current working directory.
//
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
char name1[L_tmpnam_s];
errno_t err;
int i;
for (i = 0; i < 15; i++)
{
err = tmpnam_s( name1, L_tmpnam_s );
if (err)
{
printf("Error occurred creating unique filename.\n");
exit(1);
}
else
{
printf( "%s is safe to use as a temporary file.\n", name1 );
}
}
}
C:\Users\LocalUser\AppData\Local\Temp\u19q8.0 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.1 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.2 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.3 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.4 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.5 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.6 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.7 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.8 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.9 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.a is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.b is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.c is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.d is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.e is safe to use as a temporary file.