C++ Interop (暗黙の PInvoke) の使用

他の .NET 言語とは異なり、Visual C++ には相互運用性サポートが備えられています。相互運用性サポートを使用すると、マネージ、アンマネージ プラグマにより、マネージ コードとアンマネージ コードは同じアプリケーション内、また同じファイルでも共存できるようになります。 これにより、Visual C++ 開発者は、他のアプリケーションの動作を妨げることなく、既存の Visual C++ アプリケーションに .NET 機能を統合できます。

また、dllexport、dllimport を使用して、マネージ コンパイル単位からアンマネージ関数を呼び出すこともできます。

関数パラメーターのマーシャリング方法を指定したり、DllImportAttribute を明示的に呼び出す際に指定できるその他の詳細設定を行ったりする必要がない場合は、暗黙の PInvoke を使用すると便利です。

Visual C++ では、マネージ関数とアンマネージ関数を相互運用するために 2 つの方法があります。

• C++ での明示的な PInvoke (DllImport 属性) の使用方法

明示的な PInvoke は、.NET Framework でサポートされており、ほとんどの .NET 言語で使用できます。 ただし、その名前からわかるように、C++ Interop は Visual C++ 固有の機能です。

C++ Interop

明示的な PInvoke よりも C++ Interop を使用することをお勧めします。C++ Interop は、より優れたタイプセーフを提供し、通常、実装も容易で、アンマネージ API が変更された場合もより柔軟に対処できるからです。また、明示的な PInvoke では不可能なパフォーマンスの向上も実現できます。 ただし、アンマネージ ソース コードが利用できない場合や、/clr:safe を指定してコンパイルするときは、C++ Interop は使用できません。詳細については、「純粋なコードと検証可能なコード (C++/CLI)」を参照してください。

C++ COM Interop

Visual C++ がサポートしている相互運用機能は、COM コンポーネントとの相互運用性において、他の .NET 言語に比べ特に優れた効果を発揮します。 データ型のサポートに制限が存在したり、全 COM インターフェイスのすべてのメンバーの公開が義務付けられたりするなどの、.NET Framework Tlbimp.exe (タイプ ライブラリ インポーター) の制限にとらわれることなく、C++ Interop では、COM コンポーネントに自由にアクセスでき、独立した相互運用機能アセンブリは必要ありません。 詳細については、「Using COM from .NET」を参照してください。

blittable 型

シンプルな組み込み型を使用するアンマネージ API については (「Blittable 型と非 Blittable 型」を参照)、メモリ内に同じデータ型表現があるため、特別なコーディングは必要ありません。ただし、複雑なデータ型については、明示的なデータ マーシャリングが必要です。 例については、「方法: PInvoke を使用してマネージ コードからネイティブ DLL を呼び出す」を参照してください。

使用例

// vcmcppv2_impl_dllimp.cpp
// compile with: /clr:pure user32.lib
using namespace System::Runtime::InteropServices;

// Implicit DLLImport specifying calling convention
extern "C" int __stdcall MessageBeep(int);

// explicit DLLImport needed here to use P/Invoke marshalling because
// System::String ^ is not the type of the first parameter to printf
[DllImport("msvcrt.dll", EntryPoint = "printf", CallingConvention = CallingConvention::Cdecl,  CharSet = CharSet::Ansi)]
// or just
// [DllImport("msvcrt.dll")]
int printf(System::String ^, ...); 

int main() {
   // (string literals are System::String by default)
   printf("Begin beep\n");
   MessageBeep(100000);
   printf("Done\n");
}

このセクションの内容

• 方法: C++ Interop を使用して ANSI 文字列をマーシャリングする

• 方法: C++ Interop を使用して Unicode 文字列をマーシャリングする

• 方法: C++ Interop を使用して COM 文字列をマーシャリングする

• 方法: C++ Interop を使用して構造体をマーシャリングする

• 方法: C++ Interop を使用して配列をマーシャリングする

• 方法: C++ Interop を使用してコールバックおよびデリゲートをマーシャリングする

• 方法: C++ Interop を使用して埋め込みポインターをマーシャリングする

• 方法: System::String の文字にアクセスする

• 方法: char * 文字列を System::Byte 配列に変換する

• 方法: System::String を wchar_t* または char* に変換する

• 方法: System::String を標準文字列に変換する

• 方法: 標準文字列を System::String に変換する

• 方法 : バイト配列へのポインターを取得する

• 方法: アンマネージ リソースをバイト配列に読み込む

• 方法: ネイティブ関数の参照クラスを変更する

• 方法: イメージがネイティブであるか CLR であるかを確認する

• 方法: ネイティブ DLL をグローバル アセンブリ キャッシュに追加する

• 方法: 値型への参照をネイティブ型で保持する

• 方法: アンマネージ メモリ内にオブジェクト参照を保持する

• 方法: Detect /clr コンパイルを検出する

• 方法: System::Guid と _GUID の間で変換を行う

• 方法: out パラメーターを指定する

• 方法: /clr コンパイルでネイティブ型を使用する

• 方法: ネイティブ型のハンドルを宣言する

• 方法: ネイティブ クラスを C# で使用できるようにラップする

相互運用シナリオでのデリゲートの使用については、delegate (C++ コンポーネント拡張) のトピックを参照してください。

参照

概念

マネージ コードからのネイティブ関数の呼び出し