_searchenv、_wsearchenv

發行項
06/09/2015

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

重要

這個應用程式開發介面不能用於 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 and _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 );
}