方法 : C++ Interop を使用して COM 文字列をマーシャリングする
更新 : 2007 年 11 月
このトピックでは、マネージ関数とアンマネージ関数の間で BSTR (COM プログラミングで推奨される基本文字列形式) を渡す方法を説明します。その他の文字列型との相互運用については、次のトピックを参照してください。
次のコード例では、managed, unmanaged の #pragma ディレクティブを使用してマネージ関数とアンマネージ関数を同じファイル内で実装していますが、これらの関数は、別個のファイルに定義された場合も同じように相互運用できます。アンマネージ関数のみを含むファイルは、/clr (共通言語ランタイムのコンパイル) でコンパイルする必要はありません。
使用例
次の例は、マネージ関数からアンマネージ関数に BSTR (COM プログラミングで使用される文字列形式) を渡す方法を示しています。呼び出し元のマネージ関数は、StringToBSTR を使用して、.NET System.String のコンテンツの BSTR 表現のアドレスを取得します。このポインタは、アンマネージ関数の実行中にガベージ コレクション サイクルでその物理アドレスが変更されないように、pin_ptr を使用して固定されます。ガベージ コレクタは、pin_ptr が適用範囲の外になるまでメモリを移動できません。
// 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();
}