Marshal.PtrToStringBSTR メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

Marshal.PtrToStringBSTR メソッド

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Public Shared Function PtrToStringBSTR
 ( _
    ptr As IntPtr _
) As String

Dim ptr As IntPtr
Dim returnValue As String

returnValue = Marshal.PtrToStringBSTR(ptr)

public static string PtrToStringBSTR
 (
    IntPtr ptr
)

public:
static String^ PtrToStringBSTR (
    IntPtr ptr
)

public static String PtrToStringBSTR (
    IntPtr ptr
)

public static function PtrToStringBSTR
 (
    ptr : IntPtr
) : String

戻り値
ptr パラメータの値が null 参照 (Visual Basic では Nothing) でない場合は、ネイティブ文字列のコピーを保持するマネージ文字列。それ以外の場合、このメソッドは null 参照 (Visual Basic では Nothing) を返します。

アンマネージの SysAllocString 関数および SysAllocStringLen 関数で割り当てられている文字列でだけ、このメソッドを使用してください。

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

メモ
このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。