_searchenv, _wsearchenv

Статья
04/10/2013

Используются пути среды для поиска файла.Существуют более безопасные версии этих функций; см. раздел _searchenv_s, _wsearchenv_s.

Важно
Этот API нельзя использовать в приложениях, выполняемых в Среда выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW.

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 может быть любой среды или определенной пользователем переменная- для примера, PATHLIB или INCLUDE), который определяет список путей к каталогу.Поскольку _searchenv учитывается регистр, аргумент varname должен соответствовать случай переменной среды.

Процедуры сначала ищет файл в текущей рабочей папке.Если это не удается найти файл, выглядит в каталоги, указанные в переменной среды.Если конечный файл в одном из этих каталогов, вновь созданный путь копируется в pathname.Если файл filename не найден, то свойство pathname содержит пустую объединения завершенную строку.

Буфер pathname должен быть по крайней мере символами _MAX_PATH длиной в соответствии с полнометражное такого контура.В противном случае - значение _searchenv может перелиться через границы буфер pathname и причиниться непредвиденное расширения функциональности.

версия _wsearchenv является _searchenv, и аргументов в _wsearchenv характерные черты.В остальных случаях поведение _wsearchenv и _searchenv идентично.

Если filename является пустой строкой, то эти функции возвращают ENOENT.

Если filename или pathname является NULL, обработчик вызывается недопустимого параметра, как описано в разделе Проверка параметров.Если среда выполнения может продолжить, эти функции возвращают -1 и свойству errno задано значение EINVAL.

Дополнительные сведения о errno и кодах ошибок см. в разделе константы errno.

В C, 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 );
}