WinMain 関数 (winbase.h)

[アーティクル]
06/27/2024

グラフィカル Windows ベースのアプリケーションのユーザー指定のエントリポイント。

WinMain は、アプリケーションエントリポイントに使用される従来の名前です。詳細については、「解説」を参照してください。

構文

int __clrcall WinMain(
  [in]           HINSTANCE hInstance,
  [in, optional] HINSTANCE hPrevInstance,
  [in]           LPSTR     lpCmdLine,
  [in]           int       nShowCmd
);

パラメーター

[in] hInstance

型: HINSTANCE

アプリケーションの現在のインスタンスへのハンドル。

[in, optional] hPrevInstance

型: HINSTANCE

アプリケーションの前のインスタンスへのハンドル。このパラメーターは常に NULL。別のインスタンスが既に存在するかどうかを検出する必要がある場合は、CreateMutex 関数を使用して一意の名前付きミューテックスを作成します。 ミューテックスが既に存在する場合でも、CreateMutex は成功しますが、関数は ERROR_ALREADY_EXISTSを返します。これは、最初にミューテックスが作成されたため、アプリケーションの別のインスタンスが存在することを示します。ただし、悪意のあるユーザーは、実行する前にこのミューテックスを作成し、アプリケーションが起動しないようにすることができます。このような状況を回避するには、ランダムに名前付きミューテックスを作成し、承認されたユーザーのみが取得できるように名前を格納します。または、この目的でファイルを使用することもできます。アプリケーションをユーザーごとに 1 つのインスタンスに制限するには、ユーザーのプロファイルディレクトリにロックされたファイルを作成します。

[in] lpCmdLine

型: LPSTR

プログラム名を除く、アプリケーションのコマンドライン。コマンドライン全体を取得するには、GetCommandLine 関数を使用します。

[in] nShowCmd

型: int

ウィンドウの表示方法を制御します。このパラメーターには、ShowWindow 関数の nCmdShow パラメーターで指定できる任意の値を指定できます。

戻り値

型: int

関数が成功し、WM_QUIT メッセージを受信したときに終了する場合は、そのメッセージの wParam パラメーターに含まれる終了値を返す必要があります。メッセージループに入る前に関数が終了すると、0 が返されます。

備考

WinMain 名前は、多くのプログラミングフレームワークで規則によって使用されます。プログラミングフレームワークによっては、WinMain 関数の呼び出しの前に、そのフレームワークに固有の追加のアクティビティが続く場合があります。

WinMain は、アプリケーションを初期化し、メインウィンドウを表示し、アプリケーションの実行の残りの部分の最上位レベルの制御構造であるメッセージの取得とディスパッチのループを入力する必要があります。 WM_QUIT メッセージを受信したら、メッセージループを終了します。その時点で、WinMain はアプリケーションを終了し、WM_QUIT メッセージの wParam パラメーターで渡された値を返す必要があります。 PostQuitMessage呼び出した結果として WM_QUIT が受信された場合、wParam の値は、PostQuitMessage 関数の nExitCode パラメーターの値です。詳細については、「メッセージループの作成」を参照してください。

ANSI アプリケーションでは、WinMain 関数の lpCmdLine パラメーターを使用して、プログラム名を除くコマンドライン文字列にアクセスできます。 lpCmdLine は、LPTSTR データ型ではなく、LPSTR データ型を使用します。これは、WinMain を Unicode プログラムで使用できないことを意味します。 GetCommandLineW 関数を使用して、コマンドラインを Unicode 文字列として取得できます。一部のプログラミングフレームワークでは、Unicode コマンドラインを提供する別のエントリポイントが提供される場合があります。たとえば、Microsoft Visual Studio C++ コンパイラは、Unicode エントリポイント wWinMain の名前を使用します。

例

次のコード例では、WinMain 使用する方法を示します。

#include <windows.h>

int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE hInstPrev, PSTR cmdline, int cmdshow)
{
    return MessageBox(NULL, "hello, world", "caption", 0);
}

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)

次の方法で共有

WinMain 関数 (winbase.h)

構文

パラメーター

戻り値

備考

例

必要条件

関連項目

フィードバック

その他のリソース