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