C++ におけるマーシャリングの概要

[アーティクル]
09/17/2008

混合モードでは、ネイティブ型とマネージ型の間でのデータのマーシャリングが必要になる場合があります。Visual Studio 2008 には、データのマーシャリングと変換を簡単に行うためのマーシャリングライブラリが導入されています。

マーシャリングライブラリは、marshal_context クラスの有無に関係なく使用できます。一部の変換ではコンテキストが必要になります。marshal_as 関数を使用して実装できる変換もあります。次の表は、現在サポートされている変換、それぞれの変換にコンテキストが必要かどうか、およびインクルードする必要のあるマーシャルファイルの一覧です。

変換前の型	変換後の型	マーシャルメソッド	インクルードファイル
System::String^	const char*	marshal_context	marshal.h
const char*	System::String^	marshal_as	marshal.h
char*	System::String^	marshal_as	marshal.h
System::String^	const wchar_t *	marshal_context	marshal.h
const wchar_t *	System::String^	marshal_as	marshal.h
wchar_t*	System::String^	marshal_as	marshal.h
System::IntPtr	HANDLE	marshal_as	marshal_windows.h
HANDLE	System::IntPtr	marshal_as	marshal_windows.h
System::String^	BSTR	marshal_context	marshal_windows.h
BSTR	System::String^	marshal_as	marshal.h
System::String^	bstr_t	marshal_as	marshal_windows.h
bstr_t	System::String^	marshal_as	marshal_windows.h
System::String^	std::string	marshal_as	marshal_cppstd.h
std::string	System::String^	marshal_as	marshal_cppstd.h
System::String^	std::wstring	marshal_as	marshal_cppstd.h
std::wstring	System::String^	marshal_as	marshal_cppstd.h
System::String^	CStringT<char>	marshal_as	marshal_atl.h
CStringT<char>	System::String^	marshal_as	marshal_atl.h
System::String^	CStringT<wchar_t>	marshal_as	marshal_atl.h
CStringT<wchar_t>	System::String^	marshal_as	marshal_atl.h
System::String^	CComBSTR	marshal_as	marshal_atl.h
CComBSTR	System::String^	marshal_as	marshal_atl.h

マーシャリングでコンテキストが必要となるのは、マネージデータ型からネイティブデータ型へのマーシャリングで、変換先のネイティブ型に自動クリーンアップを行うためのデストラクタがない場合だけです。マーシャリングコンテキストは、割り当てられたネイティブデータ型をそのデストラクタで破棄します。したがって、コンテキストを必要とする変換は、コンテキストが削除されると無効になります。マーシャリングされた値を保存するには、独自の変数に値をコピーする必要があります。

メモ :
複数の NULL が埋め込まれている文字列に対してマーシャリングを行うと、予期しない結果になる場合があります。文字列に NULL が埋め込まれていると、それが原因で文字列が切り捨てられる可能性があります。切り捨てられずに保持される場合もあります。

マーシャリングライブラリは拡張可能なので、独自のマーシャリング型を追加できます。マーシャリングライブラリの拡張の詳細については、「方法 : マーシャリングライブラリを拡張する」を参照してください。

以前のバージョンでは、プラットフォーム呼び出しを使用してデータをマーシャリングすることができました。PInvoke の詳細については、「マネージコードからのネイティブ関数の呼び出し」を参照してください。

参照

概念

C++ のサポートライブラリ

方法 : マーシャリングライブラリを拡張する

次の方法で共有

C++ におけるマーシャリングの概要

参照

概念

その他のリソース