_exec、 _wexec 函式

每個此系列中的函式都會載入並執行新處理序：

_execl, _wexecl
_execv, _wexecv
_execle, _wexecle

_execve, _wexecve
_execlp, _wexeclp
_execvp, _wexecvp

_execlpe, _wexeclpe
_execvpe, _wexecvpe

函式名稱結尾的字母決定了變化。

_exec 函式尾碼	描述
e	envp，環境設定的指標陣列，會傳遞至新執行緒。
l	命令列引數會分別傳遞至 _exec 函式。 一般而言用於已預先知道新處理序的參數數目時。
p	PATH 環境變數，用於尋找要執行的檔案。
v	argv，命令列引數的指標陣列，會傳遞至 _exec。 一般而言用於新處理序的參數數目為變數時。

備註

每個 _exec 函式都會載入並執行新處理序。 所有 _exec 函式都會使用相同的作業系統函式 （ CreateProcess ）。 _exec 函式會根據目前使用中的多位元組字碼頁，自動將多位元組字元字串引數處理為適當且可辨識的多位元組字元序列。 _wexec 函式是寬字元版本的 _exec 函式。 函 _wexec 式的行為與家族 _exec 對應專案相同，不同之處在于它們不會處理多位元組字元字串。

泛型文字常式對應

Tchar.h 常規	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_texecl	_execl	_execl	_wexecl
_texecle	_execle	_execle	_wexecle
_texeclp	_execlp	_execlp	_wexeclp
_texeclpe	_execlpe	_execlpe	_wexeclpe
_texecv	_execv	_execv	_wexecv
_texecve	_execve	_execve	_wexecve
_texecvp	_execvp	_execvp	_wexecvp
_texecvpe	_execvpe	_execvpe	_wexecvpe

cmdname 參數會指定要執行為新處理序的檔案。 它可以指定完整路徑 (來自根目錄)、部分路徑 (來自目前的工作目錄) 或是檔案名稱。 如果 cmdname 沒有副檔名或結尾不是句號 （.），則函 _exec 式會搜尋具名檔案。 若搜尋成功，函式會使用 .com 副檔名嘗試相同的基底名稱，然後使用 .exe、.bat 和 .cmd 副檔名。 若 cmdname 具有副檔名，則只會在搜尋中使用該副檔名。 若 cmdname 以句號結尾，_exec 會不使用副檔名搜尋 cmdname。 _execlp、_execlpe、_execvp 和 _execvpe 會在 cmdname 環境變數所指定的目錄中搜尋 PATH (使用相同的程序)。 如果 cmdname 包含磁片磁碟機規範或任何斜線（也就是，如果是相對路徑）， _exec 則呼叫只會搜尋指定的檔案;不會搜尋路徑。

將參數傳遞至新處理序，是透過提供一或多個指標給字元字串作為 _exec 呼叫中的參數。 這些字元字串會形成新處理序的參數清單。 繼承的環境設定，以及形成新處理序的參數清單的字串，兩者的合併長度不可超過 32 KB。 每個字串的 NULL 終止字元 （ \0 ） 不會包含在計數中，但會計算空白字元（自動插入以分隔參數）。

注意

字串中嵌入的空格可能會導致未預期的行為；例如，傳遞字串 _exec 至 "hi there" 會導致新處理序取得兩個引數 "hi" 和 "there"。 若目的是要使新處理序開啟名為 "hi there" 的檔案，則處理序會失敗。 您可以用引號括住字串來避免此情況："\"hi there\""。

重要

請勿在沒有明確檢查內容的情況下將使用者輸入傳遞至 _exec。 _exec 會導致呼叫 CreateProcess ，因此請記住，不合格的路徑名稱可能會導致潛在的安全性弱點。

_exec 函式會驗證它們的參數。 如果預期的參數是 Null 指標、空字串或省略，函 _exec 式會叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行，這些函式會將 errno 設定為 EINVAL ，並傳回 -1。 沒有執行任何新處理序。

引數指標可作為個別參數 (在 _execl、_execle、_execlp 和 _execlpe 中) 或作為指標陣列 (在 _execv、_execve、_execvp 和 _execvpe 中) 進行傳遞。 至少必須傳遞一個參數 arg0 給新的進程;此參數是 argv[0] 新的進程。 此參數通常是 cmdname 的複本 （不同的值不會產生錯誤。

一般而言，_execl、_execle、_execlp 和 _execlpe 呼叫是在已預先知道參數數目時使用。 參數 arg0 通常是 cmdname 的指標。 參數 arg1 到 argn 會指向形成新參數清單的字元字串。 Null 指標必須接在 argn 之後，以標示參數清單的結尾。

當新處理序的參數數目為變數時，_execv、_execve、_execvp 和 _execvpe 呼叫就很實用。 參數的指標會作為陣列 argv 進行傳遞。 參數 argv[0] 通常是 cmdname 的指標。 參數 argv[1] 到 argv[n] 會指向形成新參數清單的字元字串。 參數 argv[n+1] 必須是 NULL 標記參數清單結尾的指標。

執行 _exec 呼叫之後，已經開啟的檔案仍會在新處理序中保持開啟。 在 _execl、_execlp、_execv 和 _execvp 呼叫中，新處理序會繼承呼叫處理序的環境。 _execle、_execlpe、_execve 和 _execvpe 呼叫可透過 envp 參數傳遞環境設定的清單，來改變新處理序的環境。 envp 是字元指標的陣列，其中每個項目 (最後一個項目除外) 都會指向定義環境變數的以 Null 終止的字串。 此類字串通常具有此種格式：NAME=value，其中 NAME 是環境變數的名稱，而 value 是設定變數的字串值。 value（未以雙引號括住。陣列的最後一 envp 個專案應該是 NULL 。 當 envp 本身是 NULL 時，新處理序會繼承呼叫處理序的環境。

使用其中 _exec 一個函式執行的程式一律會載入記憶體中，就像程式 .exe 檔案標頭中的最大配置欄位設定為預設值 0xFFFFH 一樣。

呼叫 _exec 不會保留開啟檔案的轉譯模式。 如果新進程必須使用繼承自呼叫進程的檔案，請使用 _setmode 常式，將這些檔案的翻譯模式設定為所需的模式。 您必須先明確定清除 (使用 fflush 或 _flushall) 或關閉所有資料流，再進行 _exec 函式呼叫。 訊號設定不會保留在呼叫 _exec 常式所建立的新進程中。 訊號設定會在新處理序中重設為預設值。

範例

// crt_args.c
// Illustrates the following variables used for accessing
// command-line arguments and environment variables:
// argc  argv  envp
// This program will be executed by crt_exec which follows.

#include <stdio.h>

int main( int argc,  // Number of strings in array argv
char *argv[],       // Array of command-line argument strings
char **envp )       // Array of environment variable strings
{
    int count;

    // Display each command-line argument.
    printf( "\nCommand-line arguments:\n" );
    for( count = 0; count < argc; count++ )
        printf( "  argv[%d]   %s\n", count, argv[count] );

    // Display each environment variable.
    printf( "\nEnvironment variables:\n" );
    while( *envp != NULL )
        printf( "  %s\n", *(envp++) );

    return;
}

執行下列程式以執行 Crt_args.exe：

// crt_exec.c
// Illustrates the different versions of exec, including
//      _execl          _execle          _execlp          _execlpe
//      _execv          _execve          _execvp          _execvpe
//
// Although CRT_EXEC.C can exec any program, you can verify how
// different versions handle arguments and environment by
// compiling and specifying the sample program CRT_ARGS.C. See
// "_spawn, _wspawn Functions" for examples of the similar spawn
// functions.

#include <stdio.h>
#include <conio.h>
#include <process.h>

char *my_env[] =     // Environment for exec?e
{
   "THIS=environment will be",
   "PASSED=to new process by",
   "the EXEC=functions",
   NULL
};

int main( int ac, char* av[] )
{
   char *args[4];
   int ch;
   if( ac != 3 ){
      fprintf( stderr, "Usage: %s <program> <number (1-8)>\n", av[0] );
      return;
   }

   // Arguments for _execv?
   args[0] = av[1];
   args[1] = "exec??";
   args[2] = "two";
   args[3] = NULL;

   switch( atoi( av[2] ) )
   {
   case 1:
      _execl( av[1], av[1], "_execl", "two", NULL );
      break;
   case 2:
      _execle( av[1], av[1], "_execle", "two", NULL, my_env );
      break;
   case 3:
      _execlp( av[1], av[1], "_execlp", "two", NULL );
      break;
   case 4:
      _execlpe( av[1], av[1], "_execlpe", "two", NULL, my_env );
      break;
   case 5:
      _execv( av[1], args );
      break;
   case 6:
      _execve( av[1], args, my_env );
      break;
   case 7:
      _execvp( av[1], args );
      break;
   case 8:
      _execvpe( av[1], args, my_env );
      break;
   default:
      break;
   }

   // This point is reached only if exec fails.
   printf( "\nProcess was not execed." );
   exit( 0 );
}

需求

標頭：process.h

另請參閱

進程和環境控制
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn、 _wspawn 函式
system, _wsystem