インスタンスハンドル

Windows NTおよびWindows 95以降の32ビット環境(Win32)では、各プロセスごとに独自のメモリー空間を使用する。従って、プロセスごとにリロケート(再配置)する必要がないため、通常は実行可能ファイルに記載されたベースアドレス通りにメモリーに読み込まれる。

Win32では、インスタンスハンドルはプロセス内でのモジュールを識別するためのものである。異なるプロセス間でのやり取りに使われる物ではないため、同じプロセス内で一意であれば問題ない。従って、OS全体として見れば、インスタンスハンドルの値は重複している可能性がある。

Win32で、同じ実行ファイルの別インスタンスを識別するには、プロセスハンドルを使う。但しプロセスハンドルまで必要になるのは稀であり、一般的にはウィンドウハンドルでも充分と考えられる。

LoadIconやLoadMenuといったインスタンスハンドルを要求するAPIを使用する場合、インスタンスハンドルを得る必要がある。

C/C++のプログラムが起動された時点で、_tWinMain関数などでHINSTANCE型の引数が得られているので、これをグローバル変数として保存してもよいが、グローバル変数を使いたくない場合はAPIでも取得できる。

HINSTANCE hInst = (HINSTANCE)GetWindowLong(hWnd, GWL_HINSTANCE);

HICON hIcon = LoadIcon(hInst, MAKEINTRESOURCE(IDI_hogehoge));

ただし、GetWindowLong関数でHINSTANCEを得るのは古い手法であり、移植性が失われている。

64ビット対応とするためには、後述するGetWindowLongPtr関数を使用しなければならない。