_pclose
新しいコマンド プロセッサを待機し、関連するパイプのストリームを閉じます。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
int _pclose(
FILE *stream
);
パラメーター
stream
前回 _popen
を呼び出したときの値を返します。
戻り値
終了するコマンド プロセッサの終了ステータスを返すか、またはエラーが発生すると -1 を返します。 戻り値の形式は、下位バイトと上位バイトがスワップされる点を除き、 _cwait
の場合と同じです。 ストリームがNULL
されている場合、_pclose
errno
を EINVAL
に設定し、-1 を返します。
これらのエラー コードおよびその他のエラー コードの詳細については、「errno
、_doserrno
、_sys_errlist
、_sys_nerr
」を参照してください。
解説
_pclose
関数は、関連付けられた_popen
呼び出しによって開始されたコマンド プロセッサ (Cmd.exe) のプロセス ID を検索し、新しいコマンド プロセッサで_cwait
呼び出しを実行し、関連付けられたパイプのストリームを閉じます。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
_pclose |
<stdio.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。