_putenv_s, _wputenv_s

  • 아티클

환경 변수를 생성, 수정 또는 제거합니다. 이러한 함수는 CRT의 _putenv_wputenv보안 기능에 설명된 대로 보안이 향상된 버전입니다.

Important

이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

errno_t _putenv_s(
   const char *varname,
   const char *value_string
);
errno_t _wputenv_s(
   const wchar_t *varname,
   const wchar_t *value_string
);

매개 변수

varname
환경 변수 이름입니다.

value_string
환경 변수를 설정할 값입니다.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

오류 조건

varname value_string 반환 값
NULL any EINVAL
any NULL EINVAL

오류 조건 중 하나가 발생하면 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 EINVAL를 반환하고 errno를 EINVAL로 설정합니다.

설명

_putenv_s 함수는 새 환경 변수를 추가하거나 기존 환경 변수의 값을 수정합니다. 환경 변수는 프로세스가 실행되는 환경을 정의합니다(예: 프로그램에 연결할 라이브러리의 기본 검색 경로). _wputenv_s 은 _putenv_s의 와이드 문자 버전이며, envstring 에 대한 _wputenv_s 인수는 와이드 문자열입니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴 _UNICODE 정의 _MBCS 되지 않음 _MBCS 정의 _UNICODE 정의
_tputenv_s _putenv_s _putenv_s _wputenv_s

varname은 추가 또는 수정할 환경 변수의 이름이고 value_string는 변수의 값입니다. varname이 이미 환경의 일부이면 해당 값이 value_string로 대체되고, 그렇지 않으면 새로운 varname 변수 및 해당 value_string가 환경에 추가됩니다. 에 대해 빈 문자열(즉, "") value_string을 지정하여 환경에서 변수를 제거할 수 있습니다.

_putenv_s 현재 프로세스에 로컬인 환경에만 영향을 줍니다 _wputenv_s . 명령 수준 환경을 수정하는 데 사용할 수 없습니다. 이러한 함수는 운영 체제가 프로세스에 대해 만드는 환경 "세그먼트"가 아니라 런타임 라이브러리에 액세스할 수 있는 데이터 구조에서만 작동합니다. 현재 프로세스가 종료되면 환경이 호출 프로세스의 수준(대부분의 경우 운영 체제 수준)으로 되돌아갑니다. 그러나 수정된 환경을 _spawn, _exec 또는 system에 의해 생성되는 모든 새로운 프로세스에 전달할 수 있으며, 이러한 새로운 프로세스는 _putenv_s 및 _wputenv_s에 의해 추가되는 모든 새로운 항목을 가져옵니다.

환경 항목을 직접 변경하지 마세요. 대신 사용 _putenv_s 하거나 _wputenv_s 변경합니다. 특히 _environ[] 전역 배열의 요소를 직접 해제하면 잘못된 메모리가 처리될 수 있습니다.

getenv 및 _putenv_s는 전역 변수 _environ을 사용하여 환경 테이블에 액세스하고, _wgetenv 및 _wputenv_s는 _wenviron을 사용합니다. _putenv_s 및 _wputenv_s는 _environ 및 _wenviron의 값을 변경하여 envp에 대한 main 인수와 _wenvp에 대한 wmain 인수를 무효화할 수 있습니다. 따라서 환경 정보를 사용 _environ 하거나 _wenviron 액세스하는 것이 더 안전합니다. 전역 변수와 글로벌 변수의 _putenv_s 관계에 대한 자세한 내용은 다음_wenviron을 참조하세요_environ._wputenv_s

참고 항목

함수의 _putenv_s 및 _getenv_s 패밀리는 스레드로부터 안전하지 않습니다. _getenv_s는 _putenv_s가 문자열을 수정하는 동안 문자열 포인터를 반환할 수 있으므로 임의의 오류를 발생시킵니다. 이러한 함수에 대한 호출은 동기화해야 합니다.

요구 사항

루틴에서 반환된 값 필수 헤더
_putenv_s <stdlib.h>
_wputenv_s <stdlib.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

사용 _putenv_s방법을 보여 주는 샘플은 다음_wgetenv_s을 참조하세요getenv_s.

참고 항목

프로세스 및 환경 제어
getenv, _wgetenv
_searchenv, _wsearchenv