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

[アーティクル]
06/10/2015

このトピックでは、マネージ関数とアンマネージ関数の間で BSTR (COM プログラミングで推奨される基本文字列形式) を渡す方法を説明します。その他の文字列型との相互運用については、次のトピックを参照してください。

次のコード例では、マネージ、アンマネージの #pragma ディレクティブを使用してマネージ関数とアンマネージ関数を同じファイル内で実装していますが、これらの関数は、別個のファイルに定義された場合も同じように相互運用できます。アンマネージ関数のみを含むファイルは、/clr (共通言語ランタイムのコンパイル) でコンパイルする必要はありません。

使用例

次の例は、マネージ関数からアンマネージ関数に BSTR (COM プログラミングで使用される文字列形式) を渡す方法を示しています。呼び出し元のマネージ関数は、StringToBSTR を使用して、.NET System.String のコンテンツの BSTR 表現のアドレスを取得します。このポインターは、アンマネージ関数の実行中にガベージコレクションサイクルでその物理アドレスが変更されないように、pin_ptr (C++/CLI) を使用して固定されます。ガベージコレクターは、pin_ptr (C++/CLI) が適用範囲の外になるまでメモリを移動できません。

// MarshalBSTR1.cpp
// compile with: /clr
#define WINVER 0x0502
#define _AFXDLL
#include <afxwin.h>

#include <iostream>
using namespace std;

using namespace System;
using namespace System::Runtime::InteropServices;

#pragma unmanaged

void NativeTakesAString(BSTR bstr) {
   printf_s("%S", bstr);
}

#pragma managed

int main() {
   String^ s = "test string";

   IntPtr ip = Marshal::StringToBSTR(s);
   BSTR bs = static_cast<BSTR>(ip.ToPointer());
   pin_ptr<BSTR> b = &bs;

   NativeTakesAString( bs );
   Marshal::FreeBSTR(ip);
}

次の例は、アンマネージ関数からアンマネージ関数に BSTR を渡す方法を示しています。受信側のマネージ関数は、その文字列を BSTR として使用したり、または他のマネージ関数と併用するために PtrToStringBSTR を使用して String に変換したりできます。 BSTR を表すメモリはアンマネージヒープに割り当てられ、またアンマネージヒープ上にはガベージコレクションが存在しないため、固定の必要はありません。

// MarshalBSTR2.cpp
// compile with: /clr
#define WINVER 0x0502
#define _AFXDLL
#include <afxwin.h>

#include <iostream>
using namespace std;

using namespace System;
using namespace System::Runtime::InteropServices;

#pragma managed

void ManagedTakesAString(BSTR bstr) {
   String^ s = Marshal::PtrToStringBSTR(static_cast<IntPtr>(bstr));
   Console::WriteLine("(managed) convered BSTR to String: '{0}'", s);
}

#pragma unmanaged

void UnManagedFunc() {
   BSTR bs = SysAllocString(L"test string");
   printf_s("(unmanaged) passing BSTR to managed func...\n");
   ManagedTakesAString(bs);
}

#pragma managed

int main() {
   UnManagedFunc();
}

次の方法で共有

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

使用例

参照

関連項目

その他のリソース