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