_pclose

新しいコマンド プロセッサを待機し、関連するパイプのストリームを閉じます。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

int _pclose(
FILE *stream
);

パラメーター

stream
前回 _popen を呼び出したときの値を返します。

戻り値

終了するコマンド プロセッサの終了ステータスを返すか、またはエラーが発生すると -1 を返します。 戻り値の形式は、下位バイトと上位バイトがスワップされる点を除き、同じです _cwait。 stream が - _pclose 1 にEINVAL設定errnoされ、戻り値が NULL-1 の場合。

これらのエラー コードおよびその他のエラー コードの詳細については、「errno_doserrno_sys_errlist_sys_nerr」を参照してください。

解説

この関数は _pclose 、関連付けられた _popen 呼び出しによって開始されたコマンド プロセッサ (Cmd.exe) のプロセス ID を検索し、新しいコマンド プロセッサで呼び出しを実行 _cwait し、関連付けられているパイプのストリームを閉じます。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください

必要条件

ルーチンによって返される値 必須ヘッダー
_pclose <stdio.h>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

関連項目

プロセスと環境の制御
_pipe
_popen, _wpopen