_execle、_wexecle
ロードは、新しい子プロセスが実行されます。
.gif "重要 :") 重要 |
|---|
この API は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
intptr_t _execle(
const char *cmdname,
const char *arg0,
... const char *argn,
NULL,
const char *const *envp
);
intptr_t _wexecle(
const wchar_t *cmdname,
const wchar_t *arg0,
... const wchar_t *argn,
NULL,
const char *const *envp
);
パラメーター
cmdname
実行するファイルのパス。arg0, ...argn
パラメーターへのポインターのリスト。envp
環境設定へのポインターの配列。
戻り値
成功すると、これらの関数は、呼び出し元プロセスに返送されません。–1 の戻り値は errno のグローバル変数が設定されている場合、エラーを示します。
errno の値 |
説明 |
|---|---|
E2BIG |
引数と環境の設定に必要な領域は 32 KB を超えています。 |
EACCES |
指定したファイルにロック、共有違反があります。 |
EINVAL |
無効なパラメーター。 |
EMFILE |
多すぎるファイルを開いています。(実行可能であるかどうかを判定するために、指定されたファイルを開く必要があります)。 |
ENOENT |
ファイルまたはパスはありません。 |
ENOEXEC |
指定されたファイルには実行できず、無効なファイル形式はありません。 |
ENOMEM |
十分なメモリが新しいプロセスを実行して使用できません。; 使用できるメモリが破損しています; または示すの呼び出しプロセスは正しくなかったことを無効なブロックはです。 |
これらのリターン コードに関する詳細については、_doserrno、errno、_sys_errlist と_sys_nerrを参照してください。
解説
これらの各関数は、新しいプロセスを読み込んで実行し、別のパラメーターとして各コマンド ライン引数を渡し、および環境設定へのポインターの配列を渡します。
_execle の関数は、パラメーターを検証します。cmdnamearg0 またはが null ポインターまたは空の文字列の場合、これらの関数は パラメーターの検証に説明されているように、無効なパラメーター ハンドラーが実行されます。実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、-1 を返します。新しいプロセスが起動します。
必要条件
Function |
必須ヘッダー |
オプション ヘッダー |
|---|---|---|
_execle |
<process.h> |
<errno.h> |
_wexecle |
<process.h> か <wchar.h> |
<errno.h> |
詳細については、「互換性」を参照してください。
使用例
_exec、_wexec 系関数 の例を参照してください。