_searchenv _wsearchenv

發行項
03/26/2013

使用環境路徑來搜尋檔案。更多這些函式的可用安全版本，請參閱 _searchenv_s _wsearchenv_s 。

重要

這個應用程式開發介面無法用來在 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 );
}