다음을 통해 공유

_searchenv, _wsearchenv

  • 아티클

환경 경로를 사용하여 파일을 검색합니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. _searchenv_s, _wsearchenv_s(을)를 참조하세요.

Important

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

구문

void _searchenv(
   const char *filename,
   const char *varname,
   char *pathname
);
void _wsearchenv(
   const wchar_t *filename,
   const wchar_t *varname,
   wchar_t *pathname
);
template <size_t size>
void _searchenv(
   const char *filename,
   const char *varname,
   char (&pathname)[size]
); // C++ only
template <size_t size>
void _wsearchenv(
   const wchar_t *filename,
   const wchar_t *varname,
   wchar_t (&pathname)[size]
); // C++ only

매개 변수

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

varname
검색할 환경입니다.

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

설명

_searchenv 루틴은 지정된 도메인에서 대상 파일을 검색합니다. varname 변수는 디렉터리 경로 목록을 지정하는 모든 환경 변수 또는 사용자 정의 변수(예: PATH, LIB 또는 INCLUDE)일 수 있습니다. _searchenv에서 대/소문자를 구분하므로 varname은 환경 변수의 대/소문자와 일치해야 합니다.

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

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

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

filename이 빈 문자열인 경우 이 함수에서 ENOENT를 반환합니다.

포인터이거나 pathname 포인터인 NULL 경우 filename 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우 이러한 함수가 -1을 반환하고 errno 를 EINVAL로 설정합니다.

코드 및 오류 코드 errno 에 대한 errno 자세한 내용은 상수입니다.

C++에서 이러한 함수는 보다 최신의 보안 대응 함수를 호출하는 템플릿 오버로드를 갖고 있습니다. 자세한 내용은 안전한 템플릿 오버로드를 참조하세요.

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

일반 텍스트 루틴 매핑

Tchar.h 루틴 _UNICODE 및 _MBCS 정의되지 않음 정의된 _MBCS 정의된 _UNICODE
_tsearchenv _searchenv _searchenv _wsearchenv

요구 사항

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

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

예시

// crt_searchenv.c
// compile with: /W3
// This program searches for a file in
// a directory that's 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";

   // Search for file in PATH environment variable:
   _searchenv( searchfile, envvar, pathbuffer ); // C4996
   // Note: _searchenv is deprecated; consider using _searchenv_s
   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 8\VC\BIN\CL.EXE

참고 항목

디렉터리 컨트롤
getenv, _wgetenv
_putenv, _wputenv
_searchenv_s, _wsearchenv_s