Marshal.PtrToStringAuto メソッド (IntPtr, Int32)

アンマネージ メモリに格納されている文字列から、指定した文字数をマネージ String にコピーします。

Overloads Public Shared Function PtrToStringAuto( _
   ByVal ptr As IntPtr, _   ByVal len As Integer _) As String
[C#]
public static string PtrToStringAuto(IntPtrptr,intlen);
[C++]
public: static String* PtrToStringAuto(IntPtrptr,intlen);
[JScript]
public static function PtrToStringAuto(
   ptr : IntPtr,len : int) : String;

パラメータ

• ptr
  Unicode プラットフォームの場合は、先頭の Unicode 文字のアドレス。

  または

  ANSI プラットフォームの場合は、先頭の ANSI 文字のアドレス。

• len
  コピーする文字数。

戻り値

ネイティブな文字列のコピーを保持しているマネージ文字列。

例外

解説

Unicode プラットフォームの場合、このメソッドは PtrToStringUni を呼び出します。ANSI プラットフォームの場合、このメソッドは PtrToStringAnsi を呼び出します。これらのメソッドが呼び出されるまで、変換は一切行われません。

PtrToStringAuto は、カスタム マーシャリングを実行するとき、またはマネージ コードとアンマネージ コードを混在させるときに使用します。このメソッドはアンマネージ文字列の内容のコピーを作成するため、適切な形で元の文字列を解放する必要があります。 PtrToStringAnsi は、 Marshal.StringToCoTaskMemAuto と Marshal.StringToHGlobalAuto とは反対の機能を提供します。

メモ   このメソッドは 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 Framework セキュリティ:

• SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

参照

Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | Marshal.PtrToStringAuto オーバーロードの一覧 | StringToCoTaskMemAuto | StringToHGlobalAuto | PtrToStringUni | PtrToStringAnsi