C3711エラーについて解説: イベントソースメソッドの戻り値設定方法

// SampleFloatError.cpp
#include <atlbase.h>    // 必要なinclude文
#include <atlcom.h>     // 必要なinclude文
#include <atlctl.h>     // 必要なinclude文
[event_source(native)]
class EventSource {
public:
    // float型を返すためエラーが発生する例
    __event float event1(); // エラー C3711 が発生
};
[event_receiver(native)]
class EventReceiver {
public:
    // イベントハンドラー側もfloat型になっているため整合性はあるが、仕様外のためエラー
    float handler1() {
        // 拡張性のために数値を返すが、仕様では整数またはvoidが求められる
        return 0.0;  // 本来は整数値が望ましい
    }
    void HookEvents(EventSource* pSrc) {
        __hook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
    void UnhookEvents(EventSource* pSrc) {
        __unhook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
};
int main() {
    // メイン関数は必要最低限の実装
    return 0;
}

コンパイルエラー: 'event1': マネージでないイベント ソース メソッドは、void または整数型を返さなければなりません。

// CorrectReturnType.cpp
#include <atlbase.h>    // 必要なinclude文
#include <atlcom.h>     // 必要なinclude文
#include <atlctl.h>     // 必要なinclude文
[event_source(native)]
class EventSource {
public:
    // ここでは戻り値に意味を持たせないため、void型を指定
    __event void event1();
};
[event_receiver(native)]
class EventReceiver {
public:
    // 事件通知のみを行う場合、void型で実装する例
    void handler1() {
        // イベントハンドリングの処理
    }
    void HookEvents(EventSource* pSrc) {
        __hook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
    void UnhookEvents(EventSource* pSrc) {
        __unhook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
};
int main() {
    // メイン関数による基本的な実行例
    EventSource eventSrc;
    EventReceiver eventRec;
    eventRec.HookEvents(&eventSrc);
    return 0;
}

(正常にコンパイルされ、イベントフックの処理が行われる)

// CorrectReturnTypeWithInt.cpp
#include <atlbase.h>    // 必要なinclude文
#include <atlcom.h>     // 必要なinclude文
#include <atlctl.h>     // 必要なinclude文
[event_source(native)]
class EventSource {
public:
    // 処理結果を整数で返却する例(0は正常終了、非0はエラーを意味する)
    __event int event1();
};
[event_receiver(native)]
class EventReceiver {
public:
    // 整数型でイベントハンドラーを実装する例
    int handler1() {
        // イベントハンドリングの処理、正常終了を示す0を返す
        return 0;
    }
    void HookEvents(EventSource* pSrc) {
        __hook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
    void UnhookEvents(EventSource* pSrc) {
        __unhook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
};
int main() {
    // メイン関数による基本的な実行例
    EventSource eventSrc;
    EventReceiver eventRec;
    eventRec.HookEvents(&eventSrc);
    return 0;
}

(正常にコンパイルされ、イベントの返却値も正しく扱われる)

// FixedEventCode.cpp
#include <atlbase.h>    // 必要なinclude文
#include <atlcom.h>     // 必要なinclude文
#include <atlctl.h>     // 必要なinclude文
[event_source(native)]
class EventSource {
public:
    // 戻り値型をfloatからintに変更した例
    __event int event1();
};
[event_receiver(native)]
class EventReceiver {
public:
    // 戻り値型をfloatからintに変更した例、0は正常終了を意味する
    int handler1() {
        // イベント処理の実装例
        return 0;
    }
    void HookEvents(EventSource* pSrc) {
        __hook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
    void UnhookEvents(EventSource* pSrc) {
        __unhook(EventSource::event1, pSrc, EventReceiver::handler1);
    }
};
int main() {
    // 修正後のコードの動作確認のためmain関数を実装
    EventSource eventSrc;
    EventReceiver eventRec;
    eventRec.HookEvents(&eventSrc);
    return 0;
}

(正常にコンパイルされ、イベントハンドラーの戻り値も整数型として正しく処理される)