_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 变量可以是任何环境或用户定义的变量 (例如、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 );
}