C言語およびC++で発生するコンパイラエラー C3117 について解説

コンパイラ エラー C3117は、Microsoft Visual C++で__interfaceを使用する際、インターフェイスに対して複数の基底クラスを指定してしまうと発生します。

各インターフェイスは1つの基底クラスのみが許容される仕様のため、複数指定が原因でこのエラーが起こります。

この記事では、エラー例と正しい記述方法について解説します。

エラー C3117の基本情報

エラーメッセージの内容と原因

エラー C3117 は、__interface を使用する際に複数の基底クラスを指定してしまった場合に発生します。

具体的には、インターフェイスには1つの基底クラスのみが許容されるため、複数の継承が行われるとコンパイラは「’%$S’ : インターフェイスには 1 つの基底クラスのみを指定できます」というエラーメッセージを出力します。

このエラーが発生するのは、__interface の記述ルールに反しており、誤って複数の継承元が記述されていることが原因です。

対象環境と仕様の背景

__interface は主に Microsoft の開発環境において利用される拡張機能です。

Windows プラットフォーム向けの COM インターフェイス実装などで用いられることが多く、__interface を利用する際は、継承に関する仕様が厳格に定められています。

具体的には、インターフェイスは必ず1つの基底クラス(しばしば既定の基底クラス)から継承する仕様となっており、複数の継承を記述すると設計上の整合性が取れないことから、エラーが発生する仕組みになっています。

__interfaceの記述ルール

宣言方法の基本と制約

__interface はインターフェイスを定義するための専用機能であり、クラス定義と似ていますが、いくつかの重要な制約があります。

・__interface は必ず1つの基底クラスまたは既定の型からのみ継承する必要があります。

・メソッド宣言のみが可能であり、実装やメンバー変数を含むことはできません。

・COM の仕様に則った UUID 等の属性が付与される場合が多く、これによりオブジェクトの識別やバージョン管理が行われます。

複数基底クラス指定の不適切な例

複数の基底クラスを指定すると、設計上の曖昧さが生じるため、エラー C3117 が発生します。

__interface の宣言時には、1 つの基底クラスしか指定できないルールがあるため、以下のような記述は不適切です。

コード例によるエラー発生の詳細

次のサンプルコードは、複数の基底クラスを指定しているためにエラー C3117 が発生する例です。

#include <windows.h>
// I1 インターフェイスの定義
[ object, uuid("00000000-0000-0000-0000-000000000001") ]
__interface I1
{
    // メソッド宣言(例)
    void methodA();
};
// I2 インターフェイスの定義
[ object, uuid("00000000-0000-0000-0000-000000000002") ]
__interface I2
{
    // メソッド宣言(例)
    void methodB();
};
// I3 インターフェイスで複数の基底クラスを指定しているためエラーが発生
[ object, uuid("00000000-0000-0000-0000-000000000003") ]
__interface I3 : I1, I2
{
    // 追加のメソッド宣言(例)
    void methodC();
}
int main() {
    // メイン関数は空で構いません
    return 0;
}

(コンパイル時エラー)
"__interface I3 : I1, I2" の部分でエラー: インターフェイスには 1 つの基底クラスのみを指定できます。

エラー対処方法と修正手順

コンパイルエラー確認の流れ

コンパイルエラーが発生した場合は、まずエラーメッセージの内容を正確に確認することが重要です。

・エラーメッセージに「インターフェイスには 1 つの基底クラスのみを指定できます」とある場合、__interface の宣言部分を重点的に確認してください。

・複数の基底クラスが指定されていないか、または誤って列挙されていないかをチェックします。

・開発環境上で正確な箇所にエラーが示されるので、その行をもとにコード全体を見直すと良いです。

正しい宣言方法のポイント

エラーを解消するためには、1 つの基底クラスだけを指定する必要があります。

・複数の機能が必要な場合は、1 つのインターフェイスに必要なメソッドをすべて列挙するか、別の設計手法を検討することが推奨されます。

・COM 専用の __interface であるため、設計段階から継承関係を明確に保つように注意してください。

・基底クラスの選択が適切かどうか、または継承関係を変更することでエラーを防止できるかを判断します。

修正後のコード例と比較検証

以下のサンプルコードは、__interface の定義において、複数の基底クラス指定を行わずに正しく記述した例です。

#include <windows.h>
#include <iostream>
// I1 インターフェイスの定義
[ object, uuid("00000000-0000-0000-0000-000000000001") ]
__interface I1
{
    // メソッド宣言(例)
    void methodA();
};
// I2 インターフェイスの定義(独立したインターフェイスとして定義)
[ object, uuid("00000000-0000-0000-0000-000000000002") ]
__interface I2
{
    // メソッド宣言(例)
    void methodB();
};
// I3 インターフェイスの定義は I1 のみを継承
[ object, uuid("00000000-0000-0000-0000-000000000003") ]
__interface I3 : I1
{
    // 必要に応じて追加のメソッドを定義
    void methodC();
};
int main() {
    // 修正後のコードは正しくコンパイルされます。
    std::cout << "修正後のサンプルコードを実行しました。" << std::endl;
    return 0;
}

修正後のサンプルコードを実行しました。

まとめ

本記事では、C++におけるエラー C3117 の原因と対処方法について説明しました。

エラーは__interface 宣言時に複数の基底クラスを指定した場合に発生し、設計上の制約を理解することが重要です。

実際のコード例を通して誤った実装と正しい実装の違いを確認でき、適切な修正方法が理解できる内容となっています。