FreeConsole 関数

  • [アーティクル]

呼び出しプロセスをコンソールからデタッチします。

構文

BOOL WINAPI FreeConsole(void);

パラメーター

この関数にはパラメーターはありません。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

プロセスは、最大 1 つのコンソールにアタッチできます。 プロセスでは、FreeConsole 関数を使用して、本体から自身をデタッチできます。 その他のプロセスがコンソールを共有している場合、コンソールは破棄されませんが、FreeConsole と呼ばれるプロセスはそれを参照できません。 コンソールは、最後にアタッチされたプロセスが終了するか FreeConsole を呼び出すと閉じられます。 FreeConsole を呼び出すプロセスの後、AllocConsole を呼び出して新しいコンソールを作成するか、AttachConsole を呼び出して別のコンソールにアタッチできます。 呼び出しプロセスがまだコンソールにアタッチされていない場合でも、 FreeConsole 要求は成功します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー ConsoleApi.h (WinCon.h 経由、Windows.h をインクルード)
ライブラリ Kernel32.lib
[DLL] Kernel32.dll

関連項目

AllocConsole

AttachConsole

コンソール関数

コンソール