EAを開発していると、

パラメータを少し変えるだけでもOnDeinit()が呼ばれ、

チャートを閉じたときと同じ後処理が走ってしまいます。

既刊globalvariableset-get-mt4.mdのように、

OnDeinit()で状態を保存する実装をしていると、

開発中の些細な操作のたびに保存処理や通知が発生して、

煩わしく感じたことがあるかもしれません。

この記事では、UninitializeReason関数とREASON_定数を使い、

「なぜOnDeinit()が呼ばれたか」を判定し、

本当に必要な場面だけ処理を実行する方法を解説します。

この記事で分かること
・OnDeinit()が『同じ理由』で呼ばれるとは限らない理由
・UninitializeReason()とREASON_定数10個の一覧
・『保存・通知すべき理由』と『無視すべき理由』の切り分け
・既刊SendNotificationと組み合わせた実際に動くコード

UninitializeReasonとは何か

まず、OnDeinit()が抱える意外な前提を整理します。

OnDeinitは「毎回同じ処理」をしてしまいやすい

多くのEA記事のOnDeinit()は、

オブジェクトの削除やGlobalVariableの保存を、

理由を問わず一律に実行しています。

UninitializeReasonで「なぜ止まったか」が分かる

補足
・チャートを閉じた、EAを外した、再コンパイルした等、理由は複数ある
・UninitializeReason()はその理由をint型の定数で返す
・OnDeinit()の中で呼び出して初めて意味を持つ

理由が分かれば、

「本当にEAが停止した」場合だけ重要な処理を行い、

開発中の操作では何もしない、という制御ができます。

既刊globalvariableset-get-mt4.mdとの関係

既刊globalvariableset-get-mt4.mdは、

OnDeinit()での保存という「やり方」を扱いましたが、

「いつ保存すべきか」というタイミングの制御は未解説でした。

本記事はその欠けていた判断軸を補う続編です。

シグネチャとREASON_定数一覧

公式リファレンスで仕組みを確認します。

シグネチャ

公式リファレンス(UninitializeReason)によると、シグネチャは次の通りです。

int UninitializeReason();

引数は無く、OnDeinit()が呼ばれる直前に、

確定した理由コードをint型で返すだけの関数です。

REASON_定数の一覧

公式リファレンス(終了理由の定数)によると、10個の定数があります。

定数 値 発生する場面
REASON_PROGRAM 0 ExpertRemove()を呼んで自ら終了
REASON_REMOVE 1 チャートからEAを外した
REASON_RECOMPILE 2 再コンパイルした
REASON_CHARTCHANGE 3 通貨ペア・期間を変更した
REASON_CHARTCLOSE 4 チャートを閉じた
REASON_PARAMETERS 5 入力パラメータを変更した
REASON_ACCOUNT 6 別アカウントへ切り替えた
REASON_TEMPLATE 7 新しいテンプレートを適用した
REASON_INITFAILED 8 OnInit()が0以外を返して失敗した
REASON_CLOSE 9 MT4本体を終了した

保存・通知すべき理由とそうでない理由の切り分け

10個すべてを同じ重みで扱う必要はありません。

通知すべきケース(本当にEAが止まる)

REASON_REMOVE・CHARTCLOSE・CLOSEの3つは、

EAの監視が実際に止まる場面のため、

保有ポジションがあるなら通知する価値があります。

通知を避けるべきケース(開発中の操作)

注意
・PARAMETERS/RECOMPILE/CHARTCHANGE/TEMPLATEは、
監視そのものは止まらない理由
・これらで毎回通知すると、重要な通知を見落としやすい

REASON_INITFAILEDの特殊な扱い

OnInit()自体が失敗した場合は、

設定ミスの可能性が高いため、

開発中の操作とは別枠で通知する価値があります。

実際に動くコード全体:理由に応じて通知するEA

既刊SendNotificationと組み合わせ、

本当に止まった場合だけスマホに通知します。

//+------------------------------------------------------------------+
//|                                   NotifyOnRealStop.mq4            |
//|                     Copyright 2026, FX-EA System Project Creator |
//|                        https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property strict

//+------------------------------------------------------------------+
int OnInit()
  {
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
void OnDeinit(const int reason)
  {
   if(ShouldNotify(reason))
     {
      string msg = StringFormat("%s EA停止 reason=%d", Symbol(), reason);
      SendNotification(msg);
     }
  }

//+------------------------------------------------------------------+
bool ShouldNotify(const int reason)
  {
   switch(reason)
     {
      case REASON_REMOVE:
      case REASON_CHARTCLOSE:
      case REASON_CLOSE:
      case REASON_INITFAILED:
         return(true);
      default:
         return(false); //PARAMETERS/RECOMPILE/CHARTCHANGE/TEMPLATE/ACCOUNT/PROGRAMは無視
     }
  }
//+------------------------------------------------------------------+

入力パラメータ

このサンプルは判定ロジックの説明が目的のため、

入力パラメータは持たせていません。

OnDeinitの実装

OnDeinit(const int reason)の引数reasonには、

UninitializeReason()と同じ値が渡されるため、

このサンプルでは関数呼び出しを省略し、

引数reasonを直接switch文で判定しています。

MetaEditorでの実行手順

実際に動かして理由コードを確認する手順です。

  1. MetaEditorで新規EA「NotifyOnRealStop」を作成し、上のコードを貼り付ける
  2. F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  3. チャートに適用後、パラメータ設定画面を開いて何も変えずOKを押し、通知が来ないことを確認する
  4. チャートを閉じて、通知が届くことを確認する

よくあるエラーと注意点

実装時につまずきやすい点をまとめます。

UninitializeReason()はOnDeinit内でのみ意味を持つ

OnInit()やOnTick()の中で呼び出しても、

その時点ではまだ終了理由が確定していないため、

意味のある値は返ってきません。

REASON_INITFAILEDはOnDeinitの引数にも渡る

OnInit()が失敗した場合でも、

MT4は必ずOnDeinit()を呼び出すため、

この分岐を用意しておかないと検知漏れになります。

MQL5でも同じ考え方が使える

MQL5にも同名のUninitializeReason()とREASON_定数があり、

考え方・定数名はMQL4とほぼ共通しています。

よくある質問

UninitializeReasonについて、よく検索される疑問に回答します。

GetLastError()と何が違いますか?

GetLastError()は直前の関数呼び出しのエラーを返すのに対し、

UninitializeReason()はEAやインジケーター自体の、

終了理由を返す別の目的の関数です。

インジケーターでも使えますか?

使えます。

EA・カスタムインジケーターのどちらでも、

OnDeinit()の中で同じように呼び出せます。

reason番号を直接比較してもいいですか?

動作はしますが、

将来の可読性のためREASON_PROGRAM等の定数名で、

比較することを公式リファレンスも推奨しています。

【MQL4】UninitializeReason関数でEAが『なぜ止まったか』を判定する方法について解説してみた(REASON_定数とOnDeinitの正しい使い分け):まとめ

OnDeinit()は、チャートを閉じたときだけでなく、

パラメータ変更や再コンパイルでも同じように呼ばれます。

UninitializeReason()とREASON_定数を使えば、

「本当に監視が止まる場面」だけを見分けて、

既刊SendNotificationのような重要な通知を、

開発中の操作で鳴らさずに済ませられます。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事