GetConsoleWindow 関数

重要

このドキュメントでは、エコシステム ロードマップの一部ではなくなったコンソール プラットフォームの機能について説明します。 このコンテンツを新しい製品で使用することはお勧めしませんが、今後も既存の使用をサポートし続けます。 推奨される最新のソリューションでは、クロスプラットフォーム シナリオでの互換性を最大限に高める仮想ターミナル シーケンスに重点を置いています。 この設計決定の詳細については、クラシック コンソールと仮想ターミナルのドキュメントを参照してください。

呼び出しプロセスに関連付けられているコンソールによって使用されるウィンドウ ハンドルを取得します。

構文

HWND WINAPI GetConsoleWindow(void);

パラメーター

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

戻り値

戻り値は、呼び出しプロセスに関連付けられているコンソールによって使用されるウィンドウへのハンドルか、そのような関連付けられたコンソールがない場合は NULL です。

解説

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを0x0500 以降として定義します。 詳細については、「Windows ヘッダーの使用」を参照してください。

ヒント

この API は推奨されておらず、同等の 仮想ターミナル はありません。 この決定は、Windows プラットフォームを他のオペレーティング システムと意図的に調整します。 この状態は、ローカル ユーザー、セッション、および権限コンテキストにのみ関連します。 この API を使用している場合、クロスプラットフォーム ユーティリティや SSH などのトランスポートを介したアプリケーションのリモート処理は、想定どおりに動作しない可能性があります。

疑似コンソールセッション内でホストされているアプリケーションの場合、この関数はメッセージ キュー専用のウィンドウ ハンドルを返します。 疑似コンソールが他の場所の別のターミナル ウィンドウでプレゼンテーションのためにすべてのアクションをストリームにシリアル化するため、関連付けられたウィンドウはローカルに表示されません。

要件

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

関連項目

コンソール関数