SuppressUnmanagedCodeSecurityAttribute クラス

.NET Framework クラス ライブラリ リファレンス

SuppressUnmanagedCodeSecurityAttribute クラス

スタック ウォークを使用せずにマネージ コードがアンマネージ コードを呼び出すことができるようにします。このクラスは継承できません。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Method
 Or AttributeTargets.Interface Or AttributeTargets.Delegate,
 AllowMultiple:=True, Inherited:=False)> _
Public NotInheritable Class
 SuppressUnmanagedCodeSecurityAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As SuppressUnmanagedCodeSecurityAttribute

C#

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method|AttributeTargets.Interface|AttributeTargets.Delegate,
 AllowMultiple=true, Inherited=false)] 
public sealed class SuppressUnmanagedCodeSecurityAttribute
 : Attribute

C++

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Method|AttributeTargets::Interface|AttributeTargets::Delegate,
 AllowMultiple=true, Inherited=false)] 
public ref class SuppressUnmanagedCodeSecurityAttribute
 sealed : public Attribute

J#

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method|AttributeTargets.Interface|AttributeTargets.Delegate,
 AllowMultiple=true, Inherited=false) */ 
public final class SuppressUnmanagedCodeSecurityAttribute
 extends Attribute

JScript

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method|AttributeTargets.Interface|AttributeTargets.Delegate,
 AllowMultiple=true, Inherited=false) 
public final class SuppressUnmanagedCodeSecurityAttribute
 extends Attribute

解説

注意
この属性は特に注意して使用してください。使用方法を誤ると、セキュリティの脆弱性の発生につながるおそれがあります。

この属性は、ランタイム セキュリティ チェックの効率を低下させずに、ネイティブ コードを読み込む必要のあるメソッドに適用できます。アンマネージ コードを呼び出すときに実行されたスタック ウォークが実行時に省かれ、大幅に効率が向上します。クラス内でこの属性を使用すると、格納されているすべてのメソッドに適用されます。

一般的に、マネージ コードがアンマネージ コードを呼び出す (PInvoke または COM 相互運用機能を使用してネイティブ コードを呼び出す) 場合は、アンマネージ コードを呼び出すために必要なアクセス許可がすべての呼び出し元に対して与えられるようにするために、UnmanagedCode アクセス許可が要求されます。この明示的な属性を適用することによって、開発者は実行時に要求が行われないようにすることができます。開発者は、アンマネージ コードへの移行が他の手段によって十分に保護されていることを確認する必要があります。UnmanagedCode アクセス許可の要求は、リンク時にまだ発生します。たとえば、関数 A が関数 B を呼び出し、関数 B が SuppressUnmanagedCodeSecurityAttribute でマークされている場合は、関数 A にアンマネージ コードのアクセス許可が与えられているかどうかがジャスト イン タイム コンパイル時にチェックされますが、その後の実行時にはチェックされません。

この属性は、PInvoke メソッド (または PInvoke メソッドを格納しているクラス)、または相互運用呼び出しに使用するインターフェイスの定義に適用する場合にだけ有効です。その他のすべてのコンテキストでは無視されます。

この属性は、アンマネージ コードを通じてシステム リソースへアクセスできるようにするクラスを実装するときに役立ちます。アンマネージ コードへのアクセス許可がないコードは、この属性を持つクラスを呼び出して、アンマネージ コードにアクセスできます。このようにアンマネージ コードにアクセスする場合、この属性を持つクラスのライタによってクラスがセキュリティ設定されるようにプログラムされている場合に限り、安全が確保されます。それ以外の場合は、この属性は危険であり、この属性を使用するコードが不正に使用される可能性があります。

この属性は宣言セキュリティ属性ではありませんが、標準属性です。SecurityAttribute ではなく Attribute から派生します。

継承階層

System.Object
   System.Attribute
    System.Security.SuppressUnmanagedCodeSecurityAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SuppressUnmanagedCodeSecurityAttribute メンバ
System.Security 名前空間
その他の技術情報
Extending Metadata Using Attributes
セキュリティの最適化