_searchenv, _wsearchenv

아티클
06/09/2015

파일을 검색하기 위해 환경 경로를 사용합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. _searchenv_s, _wsearchenv_s를 참조하십시오.

중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 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 을 반환합니다.

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

오류 코드들과 errno 에 대한 자세한 내용은 errno 상수 를 참조하세요.

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

제네릭 텍스트 라우팅 매핑

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 );
}