Visual Studio の C/C++ で発生するコンパイラエラー C3505 の原因と対策について解説

Visual Studio などの環境で C/C++ を用いて開発する際、コンパイラ エラー C3505 が発生することがあります。

このエラーは、64ビットターゲット向けのプロジェクトで、32ビットのクロスコンパイラを使用した結果、WOW64環境下で32ビットレジストリからライブラリ情報が読み込めないことが原因です。

対策として、32ビット版と64ビット版のライブラリを共にビルド・登録するか、64ビットネイティブのコンパイラを利用する方法が推奨されます。

エラー C3505 の発生原因

Visual Studio の C/C++ コンパイラにおいてエラー C3505 が発生する原因は、主に環境間の不整合やレジストリへのアクセス権限に起因しています。

以下では、各原因について詳しく説明します。

64ビットターゲットと32ビットホストの環境差異

Visual Studio のコンパイラが 32 ビットプロセスとして実行される場合、64 ビットターゲット向けにビルドしようとすると環境間での不整合が発生することがあります。

32 ビットホストプロセスは、WOW64 で動作しているため、システムのレジストリやライブラリの参照先が 32 ビット版となり、結果として 64 ビット版ライブラリの読み込みに失敗する可能性があります。

この状況では、例えば以下のような場合にエラー C3505 が発生します。

• 64 ビット向けのプロジェクト設定で、32 ビット用に登録されたライブラリを参照する場合
• レジストリアクセスが 64 ビット版データを必要とするのに対し、32 ビットレジストリハイブから読み込もうとする場合

WOW64環境下でのレジストリアクセス制限

WOW64 環境では、32 ビットアプリケーションが実行される際に、システムの一部機能が制限されることがあります。

特に、レジストリにアクセスする際は 32 ビット用のレジストリハイブのみが見えるため、64 ビット用のレジストリキーに登録されたライブラリ情報を取得できません。

これにより、タイプライブラリ guid の読み込みエラーなどが発生するケースがあります。

レジストリのリダイレクト機能が原因で、意図した 64 ビット情報にアクセスできない点に注意が必要です。

ライブラリ読み込み失敗の具体的ケース

具体的なケースとしては、以下のような状況が考えられます。

• 64 ビット版のタイプライブラリがシステムに登録されているが、32 ビット版は存在しない。
• プロジェクト設定が誤っており、32 ビットホストプロセスで 64 ビットライブラリを参照しようとする。
• インポートするライブラリのビルドが不完全で、64 ビット版が正しく登録されていない。

これにより、コンパイラは正しいライブラリを見つけられず、エラー C3505 を発生させます。

エラー C3505 の対策方法

エラー C3505 の回避策としては、ライブラリの両方のバージョンのビルドと登録、またはネイティブの 64 ビットコンパイラの利用が有効です。

以下に各対策方法の詳細を示します。

32ビット・64ビットライブラリの両方のビルドと登録

プロジェクトで 32 ビットと 64 ビットの両方のライブラリをビルドし、システムにそれぞれを登録することで、どちらの環境でも正しいライブラリが利用できるようになります。

具体的な手順は以下の通りです。

• ソリューションの構成を 32 ビット(x86)と 64 ビット(x64)の両方でビルドする。
• それぞれの出力ライブラリをシステムに登録するために、レジストリや COM コンポーネントの登録ツール(例：regsvr32)を利用する。

以下は、32 ビットと 64 ビットライブラリの登録を確認するサンプルコードです。

#include <stdio.h>
#include <stdlib.h>
// サンプル関数: ライブラリのバージョン番号を取得する
int getLibraryVersion() {
    // 実際には、ライブラリからバージョン番号を取得する処理を記述する
    return 42; // 仮のバージョン番号
}
int main() {
    int version = getLibraryVersion();
    printf("Library Version: %d\n", version);
    return 0;
}

Library Version: 42

このサンプルは実際のライブラリ登録の手順を省略していますが、両バージョンのライブラリが適切に登録されることが重要です。

ネイティブ64ビットコンパイラの利用

ネイティブの 64 ビットコンパイラを利用することで、32 ビットホストプロセスによるレジストリリダイレクトの影響を避け、直接 64 ビットライブラリを参照することが可能になります。

以下に、具体的な方法を説明します。

VC++ディレクトリ設定の変更手順

Visual Studio のプロジェクト設定で VC++ ディレクトリを変更する手順は以下の通りです。

1. Visual Studio のソリューションエクスプローラーで対象プロジェクトを右クリックし、「プロパティ」を選択します。
2. 「構成プロパティ」→「VC++ ディレクトリ」を選択し、Include Directories および Library Directories の設定を確認します。
3. これらの設定に、64 ビットコンパイラ用のパス(例えば、C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\<version>\include など)を指定します。
4. 設定を保存して、プロジェクトを再ビルドします。

これにより、Visual Studio は 64 ビット用のライブラリとヘッダファイルを正しく参照するようになります。

コマンドラインでのツールセット有効化

Visual Studio のコマンドライン環境でネイティブ 64 ビットコンパイラを有効にするためには、vcvarsall.bat スクリプトを使用します。

手順は次の通りです。

1. コマンドプロンプトを起動します。
2. 以下のコマンドを入力して 64 ビット用の環境を有効にします。

"C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" x64

3. この環境下で、通常のビルドコマンド(例：cl /EHsc main.cpp)を実行して、64 ビットコンパイラでのビルドを行います。

この方法で、32 ビットプロセスを回避し、直接 64 ビットコンパイラを利用することが可能になります。

Visual Studio におけるプロジェクト設定の最適化

プロジェクトの環境設定を最適化することで、エラー C3505 の発生を未然に防ぐことができます。

以下、プラットフォームターゲットの確認とコンパイラ設定の最適化手順について説明します。

プラットフォームターゲットの確認と調整

Visual Studio のプロジェクト設定でターゲットプラットフォームが正しく設定されているかの確認が重要です。

具体的なチェック手順は以下の通りです。

• プロジェクトのプロパティを開き、「構成プロパティ」→「全般」を確認します。
• 「プラットフォームターゲット」が x64 に設定されているか、または意図したターゲットに合わせて設定が調整されているかを確認します。
• 必要に応じて、構成マネージャーから新しいプラットフォーム(例：x64)を追加して、適切なビルド設定を行います。

この設定により、コンパイラは正しい環境情報を参照でき、レジストリの誤った参照を防ぐことができます。

コンパイラおよび環境設定の最適化手順

コンパイラ設定や開発環境の構成を最適化することで、エラー発生のリスクを低減できます。

以下は具体的な最適化手順です。

• プロジェクトのプロパティで「C/C++」→「全般」設定を確認し、最適なインクルードディレクトリやプリプロセッサ定義を設定します。
• 「リンカ」→「全般」でライブラリディレクトリのパスが適切に設定されているか確認します。
• Debug や Release といった各構成で設定が一貫しているか再確認してください。
• 必要に応じて、vcvarsall.bat を利用して環境変数が正しく設定されているか確認することも有効です。

以上の設定変更により、プロジェクト全体で適切なアーキテクチャが対象となり、エラー発生のリスクが著しく低下します。

トラブルシューティングと注意点

エラー C3505 が再発する場合、環境設定やプロジェクト設定の再確認が必要です。

以下の内容はトラブルシューティングの際に役立つチェックリストや既知の問題への対処方法です。

エラー再発時のチェックリスト

エラーが発生した際には、以下の項目を順に確認してください。

• プロジェクトの「プラットフォームターゲット」が正しく設定されているか。
• VC++ のインクルードディレクトリおよびライブラリディレクトリのパスに誤りがないか。
• 32 ビット版と 64 ビット版のライブラリが共に正しくビルド・登録されているか。
• コマンドラインで vcvarsall.bat が正しく実行され、環境変数が正しいか。
• Visual Studio のアップデートや修正プログラムが適用されているか。

これらの項目を確認することで、環境や設定上の問題を特定できる可能性が高まります。

既知の問題とその対処方法

Visual Studio や Windows 環境では、特定のパッチ適用状況やツールセットのバージョンによって、レジストリやライブラリの参照に関する既知の問題が報告される場合があります。

主な対処方法は以下の通りです。

• Visual Studio の最新アップデートを適用し、既知のバグ修正を反映させる。
• 必要に応じて、環境変数やレジストリ設定のリセットを行い、以前の設定が影響しないようにする。
• Microsoft の公式ドキュメントやサポート情報を参照して、特定のツールセットに関する回避策を確認する。
• プロジェクトのバックアップをとり、設定変更を段階的に適用して、どの変更が解決に寄与したかを確認する。

以上の対策を講じることで、エラー C3505 の再発リスクを低減し、安定した開発環境の維持につながります。

まとめ

本記事では、Visual Studio の C/C++ コンパイラエラー C3505 の主な原因と対策について説明しています。

原因として、64ビットターゲットと32ビットホストの環境差異、WOW64環境下のレジストリアクセス制限、ライブラリ読み込み失敗の具体的ケースが挙げられます。

対策として、32ビット・64ビットライブラリの両方のビルドおよび登録、ネイティブ64ビットコンパイラの利用、VC++ディレクトリ設定やコマンドラインでのツールセット有効化、プロジェクト設定の最適化が紹介されています。