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

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

Marshal.FreeBSTR メソッド

SysFreeString を使用して BSTR を解放します。

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

Public Shared Sub FreeBSTR
 ( _
    ptr As IntPtr _
)

Dim ptr As IntPtr

Marshal.FreeBSTR(ptr)

public static void FreeBSTR
 (
    IntPtr ptr
)

public:
static void FreeBSTR (
    IntPtr ptr
)

public static void FreeBSTR
 (
    IntPtr ptr
)

public static function FreeBSTR
 (
    ptr : IntPtr
)

Marshal.FreeCoTaskMem および Marshal.FreeHGlobal と同様、メモリの割り当てを解除するときはこのメソッドを使用できます。FreeBSTR は SysFreeString COM API メソッドを呼び出して、アンマネージメソッドである SysAllocString、SysAllocStringByteLen、SysAllocStringLen、SysReAllocString、SysReAllocStringLen のいずれかで割り当てられたメモリを解放します。このようなアンマネージメソッドは、プラットフォーム呼び出しで呼び出すことができます。詳細については、「アンマネージ DLL 関数の処理」を参照してください。

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