C/C++ 分離アプリケーションおよび side-by-side アセンブリのトラブルシューティング

[アーティクル]
04/03/2023

依存するライブラリが見つからない場合は、C/C++ アプリケーションの読み込みに失敗する場合があります。ここでは、C/C++ アプリケーションの読み込みに失敗するいくつかの一般的な理由について説明し、問題を解決する手順を提示します。

side-by-side アセンブリに対する依存関係を指定するマニフェストがアプリケーションに含まれていて、そのアセンブリが実行可能ファイルと同じフォルダーにも %WINDIR%\WinSxS\ フォルダーのネイティブアセンブリキャッシュにもプライベートアセンブリとしてインストールされていないことが原因でアプリケーションが読み込みに失敗した場合、アプリケーションを実行しようとしている Windows のバージョンに応じて、次のいずれかのエラーメッセージが表示されることがあります。

アプリケーションを正しく初期化できませんでした (0xc0000135)。
アプリケーション構成が正しくないため、このアプリケーションの開始に失敗しました。アプリケーションを再度インストールすることにより問題が解決する場合があります。
指定されたプログラムを実行できません。

アプリケーションにマニフェストが含まれておらず、Windows が一般的な検索場所で見つけることができない DLL にアプリケーションが依存している場合、次のようなエラーメッセージが表示されることがあります。

"必要な DLL" が見つからなかったため、このアプリケーションを開始できませんでした。アプリケーションをインストールし直すとこの問題は解決される場合があります。

Visual Studio がインストールされていないコンピューターにアプリケーションが配置されていて、上記と似たエラーメッセージでアプリケーションがクラッシュした場合は、次の点を確認してください。

「Visual C++ アプリケーションの依存関係の理解」で説明されている手順に従います。 Dependency Walker では、アプリケーションまたは DLL のほとんどの依存関係を表示できます。表示されていない DLL がある場合は、アプリケーションを実行するコンピューターにその DLL をインストールしてください。
オペレーティングシステムローダーは、アプリケーションマニフェストを使用してアプリケーションが依存するアセンブリを読み込みます。マニフェストは、リソースとしてバイナリに埋め込むことも、個別のファイルとしてアプリケーションフォルダーにインストールすることもできます。マニフェストがバイナリ内に埋め込まれているかどうかを確認するには、Visual Studio でバイナリを開き、リソースの一覧で RT_MANIFEST を探します。埋め込まれたマニフェストが見つからない場合は、アプリケーションフォルダーで <binary_name>.<extension>.manifest のような名前のファイルを探します。
アプリケーションが side-by-side アセンブリに依存していて、マニフェストが存在しない場合は、リンカーにプロジェクトのマニフェストを生成させる必要があります。プロジェクトの [プロジェクトのプロパティ] ダイアログボックスの [マニフェストの生成] リンカーオプションをオンにします。
マニフェストがライブラリ内に埋め込まれている場合は、RT_MANIFEST の ID がこのタイプのバイナリに適した ID であることを確認します。使用するリソース ID の詳細については、side-by-side アセンブリをリソースとして使用する方法 (Windows) に関する記事をご覧ください。マニフェストが個別ファイルの場合は、XML エディターまたはテキストエディターで開きます。マニフェストおよび配置のルールの詳細については、「マニフェスト」をご覧ください。

Note

埋め込みマニフェストと個別マニフェストファイルの両方が存在する場合、オペレーティングシステムローダーは埋め込みマニフェストを使用し、個別ファイルは無視します。ただし、Windows XP ではその反対です。つまり、個別マニフェストファイルが使用され、埋め込みマニフェストは無視されます。
DLL が LoadLibrary 呼び出しによって読み込まれるときには外部マニフェストは無視されるため、すべての DLL にマニフェストを埋め込むことをお勧めします。詳細については、「アセンブリマニフェスト」をご覧ください。
マニフェストに列挙されているすべてのアセンブリがコンピューターに正しくインストールされていることを確認します。各アセンブリは、名前、バージョン番号、およびプロセッサアーキテクチャでマニフェストに指定されます。アプリケーションが side-by-side アセンブリに依存している場合は、「アセンブリ検索シーケンス」で説明されているように、これらのアセンブリがコンピューターに適切にインストールされていて、オペレーティングシステムローダーで検出できることを確認してください。 64 ビットアセンブリは、32 ビットプロセスで読み込んだり、32 ビットオペレーティングシステムで実行したりできないことに注意してください。

例

Visual C++ を使用してビルドされた appl.exe というアプリケーションがあるとします。アプリケーションマニフェストは、ID が 1 のバイナリリソース RT_MANIFEST として appl.exe 内に埋め込まれているか、個別ファイル appl.exe.manifest として格納されています。このマニフェストの内容は次のようになります。

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" name="Fabrikam.SxS.Library" version="2.0.20121.0" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3e"></assemblyIdentity>
    </dependentAssembly>
  </dependency>
</assembly>

このマニフェストは、オペレーティングシステムローダーに対して、appl.exe が、32 ビットの x86 プロセッサアーキテクチャ用にビルドされた Fabrikam.SxS.Library という名前のバージョン 2.0.20121.0 のアセンブリに依存していることを通知します。依存 side-by-side アセンブリは、共有アセンブリまたはプライベートアセンブリとしてインストールできます。

共有アセンブリのアセンブリマニフェストは、%WINDIR%\WinSxS\Manifests\ フォルダーにインストールされます。また、アセンブリを識別して、その内容 (アセンブリに含まれる DLL) を一覧表示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <noInheritable/>
   <assemblyIdentity type="win32" name="Fabrikam.SxS.Library" version="2.0.20121.0" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3e"/>
   <file name="Fabrikam.Main.dll" hash="3ca5156e8212449db6c622c3d10f37d9adb1ab12" hashalg="SHA1"/>
   <file name="Fabrikam.Helper.dll" hash="92cf8a9bb066aea821d324ca4695c69e55b2d1c2" hashalg="SHA1"/>
</assembly>

side-by-side アセンブリは、ポリシーファイルとも呼ばれるパブリッシャー構成ファイルを使用して、アプリケーションおよびアセンブリが、あるバージョンの side-by-side アセンブリを別のバージョンの side-by-side アセンブリの代わりに使用するようにグローバルにリダイレクトすることもできます。共有アセンブリのポリシーは、%WINDIR%\WinSxS\Policies\ フォルダーで確認できます。ポリシーファイルの例を次に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">

   <assemblyIdentity type="win32-policy" name="policy.2.0.Fabrikam.SxS.Library" version="2.0.20121.0" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3e"/>
   <dependency>
      <dependentAssembly>
         <assemblyIdentity type="win32" name="Fabrikam.SxS.Library" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3e"/>
         <bindingRedirect oldVersion="2.0.10000.0-2.0.20120.99" newVersion="2.0.20121.0"/>
      </dependentAssembly>
   </dependency>
</assembly>

このポリシーファイルは、アプリケーションまたはアセンブリが、このアセンブリのバージョン 2.0.10000.0 を要求する場合は、代わりにシステムに現在インストールされているバージョン 2.0.20121.0 を使用するように指定しています。アプリケーションのマニフェストで示されたアセンブリのバージョンがポリシーファイルに指定されている場合、ローダーは、マニフェストで指定されたバージョンのアセンブリを、%WINDIR%\WinSxS\ フォルダーで探します。このバージョンがインストールされていない場合、読み込みは失敗します。バージョン 2.0.20121.0 のアセンブリがインストールされていない場合、バージョン 2.0.10000.0 のアセンブリを要求するアプリケーションで読み込みが失敗します。

ただし、アセンブリは、インストールされたアプリケーションのフォルダーにプライベート side-by-side アセンブリとしてインストールされている可能性もあります。オペレーティングシステムは、共有アセンブリとしてのアセンブリの検出に失敗した場合、そのアセンブリをプライベートアセンブリとして次の順序で検索します。

アプリケーションフォルダーで <assemblyName>.manifest という名前のマニフェストファイルを検索します。この例では、ローダーは、appl.exe が格納されているフォルダーで Fabrikam.SxS.Library.manifest を検索します。マニフェストが見つかった場合、ローダーはアプリケーションフォルダーからアセンブリを読み込みます。アセンブリが見つからない場合、読み込みは失敗します。
appl.exe が格納されているフォルダーで \<assemblyName>\ フォルダーを開こうとして、\<assemblyName>\ が存在する場合は、このフォルダーから <assemblyName>.manifest という名前のマニフェストファイルを読み込もうとします。マニフェストが見つかった場合、ローダーにより \<assemblyName>\ フォルダーからアセンブリが読み込まれます。アセンブリが見つからない場合、読み込みは失敗します。

ローダーが依存アセンブリを検索するしくみについて詳しくは、「アセンブリ検索シーケンス」をご覧ください。ローダーがプライベートアセンブリとしての依存アセンブリの検出に失敗した場合、読み込みは失敗し、"指定されたプログラムを実行できません。" というメッセージが表示されます。このエラーを解決するには、依存アセンブリとそれを構成する DLL をプライベートアセンブリまたは共有アセンブリとしてコンピューターにインストールする必要があります。

次の方法で共有

C/C++ 分離アプリケーションおよび side-by-side アセンブリのトラブルシューティング

例

関連項目

フィードバック

その他のリソース