コンパイラエラー

C言語におけるコンパイラエラー C3385 の原因と対策を解説

2025-03-29更新日: 2025-03-29

コンパイラエラー C3385 は、DllImport 属性を付与した関数がクラスのインスタンスを返す宣言になっている場合に発生します。

外部 DLL の関数として定義されるため、返り値にクラス型を利用することが認められておらず、エラーとなります。

返却型を基本型やポインタ型に変更することで、対応できます。

目次から探す

エラー概要
- エラー C3385 の基本情報
- 発生条件と環境
エラー原因の詳細
- DllImport 属性の仕様制約
- 言語仕様との関連性
解決方法と対策
- 返り値型変更による対応策
- 開発環境での調整方法
デバッグと実装確認
まとめ

エラー概要

エラー C3385 の基本情報

エラー C3385 は、DllImport 属性を設定した関数がクラスのインスタンスを返す場合に発生します。

このエラーは、.dll ファイルにある関数として宣言された関数が、マネージドコードとの境界で適切にシリアライズできないクラス型のインスタンスを返すときに出力されます。

たとえば、次のようなコードはエラーを引き起こします。

DllImport 属性が付与された関数は、クラスのインスタンスではなく、基本型、ポインタ型、または適切な構造体型を返す必要があります。

発生条件と環境

エラー C3385 は主に次のような条件で発生します。

C++/CLI で /clr オプションを利用してビルドしている場合
関数に DllImport 属性を設定しているとき
関数の返り値がクラスのインスタンス(値型ではなく参照型)であるとき

これらの環境下で、.NET ランタイムが関数の戻り値を正しくマネージドコードに変換できないため、コンパイラがエラーを出力します。

エラー原因の詳細

DllImport 属性の仕様制約

DllImport 属性は、外部 DLL の関数呼び出しを実現するための手段ですが、関数の戻り値としてクラスのインスタンスを返すことはサポートされません。

この仕様は、.NET のマーシャリング機能がクラス型のデータをうまく扱えないことに由来しています。

クラスインスタンス返却の問題点

クラスのインスタンスは、ガーベッジコレクションや複雑な参照管理の対象となるため、DLL 間の境界を超えるデータとして扱うと不整合が生じます。

そのため、DllImport 属性を利用する場合は、返り値をクラスのインスタンスにせず、シンプルな型やポインタ型に変更する必要があります。

エラー発生時には「DllImport カスタム属性を含む関数は、クラスのインスタンスを返せません」というメッセージが表示されます。

他の返り値型との比較

一方、基本型(整数型、浮動小数点型など)やポインタ型、あるいは構造体型(値型)であれば、マーシャリングにおいて安全に変換できるため、エラーは発生しません。

たとえば、以下のように SomeStruct1 のポインタを返す方法ならエラーは回避されます。

返り値に基本型や単純なポインタ型を使用する
必要に応じて構造体を値として返すように変更する

言語仕様との関連性

このエラーは、C++/CLI および .NET のマーシャリング機能における仕様が直接影響しています。

C++/CLI は C++ の拡張として .NET 対応機能を持っていますが、管理対象コードと非管理対象コードの間でデータをやりとりする際には、返り値の型に制約があります。

そのため、クラス型のインスタンスはマネージドコードへの戻り値として適切に扱えず、エラーが発生する仕組みになっています。

解決方法と対策

返り値型変更による対応策

最もシンプルな対策は、返り値型をクラスのインスタンスから基本型、ポインタ型、または構造体型(値型)に変更することです。

返り値型を変更することで、マーシャリングが正常に動作し、DLL 間で安全にデータがやりとりできるようになります。

基本型・ポインタ型への変更例

たとえば、元々以下のようなコードでエラーが発生する場合を考えます。

// 修正前のコード例
#include <stdio.h>
#include <stdlib.h>
#include <windows.h>
using namespace System;
using namespace System::Runtime::InteropServices;
// 値型の構造体(ただしクラスではなく、値型の構造体とする必要がある)
struct SomeStruct1 {
    int value;
};
public ref struct Wrap {
    [DllImport("somedll.dll", CharSet = CharSet::Unicode)]
    static SomeStruct1 f1(SomeStruct1* pS);  // エラー C3385 発生
};
int main(void) {
    SomeStruct1 s = { 0 };
    // f1 の呼び出しはできないためサンプル実行としては空実装
    printf("サンプル実行開始\n");
    return 0;
}

この場合、返り値が構造体値であっても、クラスのインスタンスとして扱われるとエラーとなる可能性があります。

そこで、返り値型をポインタ型に変更する方法が考えられます。

次に、修正後の例を示します。

// 修正後のコード例
#include <stdio.h>
#include <stdlib.h>
#include <windows.h>
using namespace System;
using namespace System::Runtime::InteropServices;
struct SomeStruct1 {
    int value;
};
public ref struct Wrap {
    // ポインタ型に変更することで、マーシャリングが可能となる
    [DllImport("somedll.dll", CharSet = CharSet::Unicode)]
    static SomeStruct1* f1(SomeStruct1* pS);
};
int main(void) {
    SomeStruct1 s = { 100 };
    // f1 の呼び出しは DLL の実装に依存するが、サンプルとしてポインタを受け取れる形に変更
    SomeStruct1* pResult = Wrap::f1(&s);
    if (pResult != NULL) {
        // 結果が正しくマーシャリングされた場合の処理(サンプル出力)
        printf("Value: %d\n", pResult->value);
    } else {
        printf("NULL ポインタが返されました\n");
    }
    return 0;
}

サンプル実行開始

上記のコードでは、返り値型を SomeStruct1型から SomeStruct1*型に変更しています。

これにより、DLL 間のデータ交換時に問題が発生せず、エラーが解消できる可能性が高くなります。

修正前後のコード比較

返り値をクラスのインスタンスとして定義してしまうと、.NET ランタイムによるマーシャリング時にトラブルが発生します。

そのため、以下のポイントで修正が必要です。

修正前:
- 返り値がクラスのインスタンス(または非値型の型)となっている
- DLL インポート時に、クラスインスタンスの生成・破棄に関する問題が発生する
修正後:
- 返り値をポインタ型または基本型(値型)に変更
- マーシャリングが正常に行われ、関数呼び出し時の動作が保証される

コード比較の観点では、返り値の定義部分のみではなく、関数呼び出し時の使用方法も修正が必要となります。

返り値をポインタ型にすることで、呼び出し側での NULL チェックなどのエラーハンドリングも適用できます。

開発環境での調整方法

開発環境が既に構築済みの場合、以下の点にも注意してください。

プロジェクト設定で /clr オプションが正しく有効になっているか確認する
DLL 関数のエクスポート定義が正しく行われているかチェックする
マーシャリングに必要な型変換が正しく実装されているか検証する

これらの調整は、開発環境外部の設定として扱う必要があります。

エラーが解消されない場合、DLL の実装側と呼び出し側の型定義が一致しているか再確認してください。

デバッグと実装確認

エラーメッセージ解析の手法

エラーメッセージ「DllImport カスタム属性を含む関数は、クラスのインスタンスを返せません」という内容は、問題の核心を示しています。

エラーメッセージの解析方法としては、次の手順が有効です。

エラーメッセージ中の返り値型に注目し、不適切な型が使用されていないか確認する
該当する DllImport 属性の設定を見直す
マネージドコードと非管理対象コードの境界での型変換に関連するドキュメント(Microsoft Learn など)を参照する

これにより、エラー発生箇所を特定しやすくなります。

ビルド検証とテスト手順

修正後のコードが正常に動作するかどうかは、ビルドと実行テストで確認します。

ビルド検証とテストの手順は以下の通りです。

修正後のコードをビルドしてエラーが解消されたか確認する
サンプルコードの main 関数を実行し、返り値の正しさをチェックする
DLL 関数の呼び出し結果をログ出力などで確認し、期待するデータが得られているかテストする

テストの自動化やデバッグ出力を利用することで、問題の箇所を迅速に特定できるようになります。

特に、ポインタ型に変更した場合は、NULL チェックやメモリ管理に留意し、安定した動作が確認できるように実装してください。

サンプルコードによるビルド検証例

次のサンプルコードは、ビルド検証を行うための簡単な例です。

// サンプルコード: DLL 関数の呼び出しを模擬
#include <stdio.h>
#include <stdlib.h>
#include <windows.h>
using namespace System;
using namespace System::Runtime::InteropServices;
struct SimpleStruct {
    int data;
};
public ref struct NativeWrap {
    // サンプルとして DLL の代わりに、単純な関数を定義
    [DllImport("dummy.dll", CharSet = CharSet::Unicode)]
    static SimpleStruct* GetSimpleStruct(SimpleStruct* pInput);
};
int main(void) {
    SimpleStruct s = { 42 };
    // 実際の DLL 関数呼び出しはダミーだが、コンパイルとリンクの確認を目的とする
    SimpleStruct* pResult = NativeWrap::GetSimpleStruct(&s);
    // 結果チェック(実際の DLL が存在しない場合は NULL チェックのみ)
    if (pResult != NULL) {
        printf("取得したデータ: %d\n", pResult->data);
    } else {
        printf("DLL 呼び出しに失敗しました\n");
    }
    return 0;
}

DLL 呼び出しに失敗しました

上記のサンプルでは、実際に DLL に存在する関数を呼び出すのではなく、型定義やマーシャリングの問題がないかを確認するためのコードとなっています。

このように、ビルドと実行テストを行うことで、修正後の実装が問題なく動作するか検証できます。

まとめ

この記事では、エラー C3385 の概要と発生条件、DllImport 属性の仕様制約に伴う返り値型の問題について解説しています。

クラスインスタンス返却が引き起こす問題や、基本型・ポインタ型への変更による対策、さらに開発環境での調整方法とデバッグ手法について学べます。

これにより、DLL関数呼び出し時のマーシャリングエラー解消の具体的な手段を理解できます。