_searchenv_s, _wsearchenv_s

환경 경로를 사용하여 파일을 검색합니다. 이러한 버전은 CRT의 _wsearchenv_searchenv 보안 기능에 설명된 대로 향상된 보안 기능을 제공합니다.

구문

errno_t _searchenv_s(
   const char *filename,
   const char *varname,
   char *pathname,
   size_t numberOfElements
);
errno_t _wsearchenv_s(
   const wchar_t *filename,
   const wchar_t *varname,
   wchar_t *pathname,
   size_t numberOfElements
);
template <size_t size>
errno_t _searchenv_s(
   const char *filename,
   const char *varname,
   char (&pathname)[size]
); // C++ only
template <size_t size>
errno_t _wsearchenv_s(
   const wchar_t *filename,
   const wchar_t *varname,
   wchar_t (&pathname)[size]
); // C++ only

매개 변수

filename
검색할 파일의 이름입니다.

varname
검색할 환경입니다.

pathname
전체 경로를 저장할 버퍼입니다.

numberOfElements
버퍼의 pathname 크기입니다.

반환 값

성공 시 0이고, 실패 시 오류 코드입니다.

filename이 빈 문자열이면 반환 값은 ENOENT입니다.

오류 조건

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

설명

_searchenv_s 루틴은 지정된 도메인에서 대상 파일을 검색합니다. varname 변수는 디렉터리 경로 목록을 지정하는 모든 환경 변수 또는 사용자 정의 변수(예: PATH, LIB 또는 INCLUDE)일 수 있습니다. _searchenv_s에서 대/소문자를 구분하므로 varname은 환경 변수의 대/소문자와 일치해야 합니다. 프로세스의 환경에 정의된 환경 변수의 이름과 일치하지 않으면 varname 함수는 0을 반환하고 pathname 변수는 변경되지 않습니다.

루틴은 먼저 현재 작업 디렉터리에서 파일을 검색합니다. 파일을 찾을 수 없으면 환경 변수에 지정된 디렉터리를 찾습니다. 대상 파일이 이러한 디렉터리 중 하나에 있는 경우 새로 만든 경로가 pathname에 복사됩니다. filename 파일을 찾을 pathname 수 없으면 빈 null로 끝나는 문자열이 포함됩니다.

pathname 버퍼가 생성된 경로 이름의 전체 길이를 수용하려면 _MAX_PATH자 이상이어야 합니다. 그렇지 않으면 _searchenv_s가 pathname 버퍼를 오버런하여 예기치 않은 동작이 발생할 수 있습니다.

_wsearchenv_s 는 _searchenv_s의 와이드 문자 버전이며, _wsearchenv_s 에 대한 인수는 와이드 문자 문자열입니다. 그렇지 않으면_wsearchenv_s 과 _searchenv_s 이 동일하게 작동합니다.

C++에서는 템플릿 오버로드로 인해 이러한 함수를 사용하는 것이 보다 간단해 집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으며(크기 인수를 지정할 필요가 없어짐), 기존의 비보안 함수를 보다 최신의 보안 대응 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드를 참조하세요.

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

일반 텍스트 루틴 매핑

요구 사항

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

예시

// crt_searchenv_s.c
/* This program searches for a file in
* a directory specified by an environment variable.
*/

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char pathbuffer[_MAX_PATH];
   char searchfile[] = "CL.EXE";
   char envvar[] = "PATH";
   errno_t err;

   /* Search for file in PATH environment variable: */
   err = _searchenv_s( searchfile, envvar, pathbuffer, _MAX_PATH );
   if (err != 0)
   {
      printf("Error searching the path. Error code: %d\n", err);
   }
   if( *pathbuffer != '\0' )
      printf( "Path for %s:\n%s\n", searchfile, pathbuffer );
   else
      printf( "%s not found\n", searchfile );
}

Path for CL.EXE:
C:\Program Files\Microsoft Visual Studio 2010\VC\BIN\CL.EXE

참고 항목

디렉터리 컨트롤
_searchenv, _wsearchenv
getenv, _wgetenv
_putenv, _wputenv