AllocConsole

呼び出し側プロセスに新しいコンソールを割り当てる AllocConsole 関数に関するリファレンス情報を参照のこと。

AllocConsole

(プラグイン / モジュール : kernel32.dll)

解説

呼び出し側プロセスに新しいコンソールを割り当てる AllocConsole 関数に関するリファレンス情報を参照のこと。

[戻り値]
この関数にはパラメータがない。
関数が成功した場合、戻り値はゼロ以外。関数が失敗した場合、戻り値はゼロ。拡張エラー情報を取得するには
[**GetLastError**](/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror)
を呼ぶ。

[備考]
プロセスは 1
つのコンソールにのみ関連付けることができるため、呼び出し側プロセスがすでにコンソールを持っている場合、**AllocConsole**
関数は失敗する。プロセスは [**FreeConsole**](freeconsole.md)
関数を使って現在のコンソールから切り離し、その後 **AllocConsole**
を呼んで新しいコンソールを作成するか、[**AttachConsole**](attachconsole.md)
を呼んで別のコンソールにアタッチできる。呼び出し側プロセスが子プロセスを作成すると、子プロセスは新しいコンソールを継承する。**AllocConsole**
は新しいコンソール用に標準入力、標準出力、標準エラーのハンドルを初期化する。標準入力ハンドルはコンソールの入力バッファへのハンドル、標準出力と標準エラーのハンドルはコンソールのスクリーンバッファへのハンドルとなる。これらのハンドルを取得するには
[**GetStdHandle**](getstdhandle.md) 関数を使う。この関数は主に、コンソールウィンドウを作成する GUI
アプリケーションで利用される。GUI
アプリケーションはコンソールなしで初期化される。コンソールアプリケーションは、[**CreateProcess**](/windows/win32/api/processthreadsapi/nf-processthreadsapi-createprocessa)
を **DETACHED\_PROCESS**
フラグ付きで呼んで切り離しプロセスとして作成された場合を除き、コンソール付きで初期化される。

情報