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

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

Marshal.SecureStringToBSTR メソッド

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

Public Shared Function SecureStringToBSTR
 ( _
    s As SecureString _
) As IntPtr

Dim s As SecureString
Dim returnValue As IntPtr

returnValue = Marshal.SecureStringToBSTR(s)

public static IntPtr SecureStringToBSTR (
    SecureString s
)

public:
static IntPtr SecureStringToBSTR (
    SecureString^ s
)

public static IntPtr SecureStringToBSTR (
    SecureString s
)

public static function SecureStringToBSTR
 (
    s : SecureString
) : IntPtr

戻り値
s パラメータのコピー先となったアンマネージメモリ内のアドレス。null SecureString オブジェクトが提供された場合は 0。

例外の種類	条件
ArgumentNullException	s パラメータが null 参照 (Visual Basic では Nothing) です。
NotSupportedException	現在のコンピュータは、Microsoft Windows 2000 Service Pack 3 以降を実行していません。
OutOfMemoryException	使用できるメモリが不足しています。

SecureStringToBSTR メソッドは、カスタムマーシャリングを実行する場合、またはマネージコードとアンマネージコードを混在させる場合に役立ちます。このメソッドは文字列で必要とされるアンマネージメモリを割り当てるため、終了時には必ず ZeroFreeBSTR メソッドを呼び出して BSTR を解放してください。

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