Marshal.PtrToStringUni メソッド (IntPtr, Int32)
ネイティブ ヒープに格納されている Unicode 文字列から、指定した文字数をマネージ String にコピーします。
Overloads Public Shared Function PtrToStringUni( _
ByVal ptr As IntPtr, _ ByVal len As Integer _) As String
[C#]
public static string PtrToStringUni(IntPtrptr,intlen);
[C++]
public: static String* PtrToStringUni(IntPtrptr,intlen);
[JScript]
public static function PtrToStringUni(
ptr : IntPtr,len : int) : String;
パラメータ
- ptr
アンマネージ文字列の最初の文字のアドレス。 - len
コピーする Unicode 文字の数。
戻り値
ネイティブな文字列のコピーを保持しているマネージ文字列。
例外
例外の種類 | 条件 |
---|---|
ArgumentException | len が 0 未満です。 |
ArgumentNullException | ptr が null 参照 (Visual Basic では Nothing) です。 |
解説
PtrToStringUni は、カスタム マーシャリングを実行するとき、またはマネージ コードとアンマネージ コードを混在させるときに使用します。このメソッドはアンマネージ文字列の内容のコピーを作成するため、適切な形で元の文字列を解放する必要があります。このメソッドは、 Marshal.StringToCoTaskMemUni および Marshal.StringToHGlobalUni とは反対の機能を提供します。
メモ このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。 SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。 LinkDemand メンバの使用に関する重要な制約事項については、「 Demand と LinkDemand 」を参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
.NET Framework セキュリティ:
- SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
参照
Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | Marshal.PtrToStringUni オーバーロードの一覧 | StringToCoTaskMemAnsi | StringToHGlobalAnsi