CriticalHandle

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

CriticalHandle クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ハンドル リソースのラッパー クラスを表します。

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

Visual Basic (宣言)

Public MustInherit Class
 CriticalHandle
    Inherits CriticalFinalizerObject
    Implements IDisposable

Visual Basic (使用法)

Dim instance As CriticalHandle

C#

public abstract class CriticalHandle : CriticalFinalizerObject,
 IDisposable

C++

public ref class CriticalHandle abstract :
 public CriticalFinalizerObject, IDisposable

J#

public abstract class CriticalHandle extends
 CriticalFinalizerObject implements IDisposable

JScript

public abstract class CriticalHandle extends
 CriticalFinalizerObject implements IDisposable

解説

CriticalHandle クラスは、SafeHandle クラスと似ていますが、SafeHandle が参照カウントを実装する点が異なります。独自に必要な同期化をより効率的に提供できる場合には、SafeHandle の代わりに CriticalHandle を使用することで、パフォーマンスの問題に対処できます。

CriticalHandle クラスは参照カウントを実行しないため、ハンドル リサイクルによるセキュリティ攻撃に対する防御が用意されていません。参照カウント アルゴリズムは暗黙的に操作をシリアル化するので、ある程度のスレッド セーフも失われます。ハンドルを使用する操作が別のスレッドで保留されている間に IDisposable.Dispose メソッドまたは Close メソッドを呼び出した場合、または同時に 2 つのスレッドから IDisposable.Dispose または Close を呼び出した場合、結果は非決定的となります。CriticalHandle クラスは、引き続き CriticalFinalizerObject クラスが提供する保証された重大な終了処理も行います。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。 UnmanagedCode (関連する列挙体)。Demand (セキュリティ アクション)。

継承階層

System.Object
   System.Runtime.ConstrainedExecution.CriticalFinalizerObject
    System.Runtime.InteropServices.CriticalHandle
       Microsoft.Win32.SafeHandles.CriticalHandleMinusOneIsInvalid
       Microsoft.Win32.SafeHandles.CriticalHandleZeroOrMinusOneIsInvalid

スレッド セーフ

この型の 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

参照

関連項目
CriticalHandle メンバ
System.Runtime.InteropServices 名前空間
SafeHandle
Microsoft.Win32.SafeHandles

CriticalHandle コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定した無効なハンドル値を使用して、CriticalHandle クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New ( _
    invalidHandleValue As IntPtr _
)

Visual Basic (使用法)

Dim invalidHandleValue As IntPtr

Dim instance As New CriticalHandle(invalidHandleValue)

C#

protected CriticalHandle (
    IntPtr invalidHandleValue
)

C++

protected:
CriticalHandle (
    IntPtr invalidHandleValue
)

J#

protected CriticalHandle (
    IntPtr invalidHandleValue
)

JScript

protected function CriticalHandle (
    invalidHandleValue : IntPtr
)

パラメータ

invalidHandleValue

無効なハンドルの値 (通常は 0 または -1)。

例外

例外の種類	条件
TypeLoadException	派生クラスがアンマネージ コードのアクセス許可なしにアセンブリに存在しています。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。 UnmanagedCode (関連する列挙体)。LinkDemand (セキュリティ アクション)。

プラットフォーム

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

参照

関連項目
CriticalHandle クラス
CriticalHandle メンバ
System.Runtime.InteropServices 名前空間
SafeHandle

CriticalHandle フィールド

プロテクト フィールド

	名前	説明
	handle	ラップされるハンドルを指定します。

参照

関連項目

CriticalHandle クラス
System.Runtime.InteropServices 名前空間
SafeHandle
Microsoft.Win32.SafeHandles

CriticalHandle プロパティ

パブリック プロパティ

	名前	説明
	IsClosed	ハンドルが閉じているかどうかを示す値を取得します。
	IsInvalid	派生クラスでオーバーライドされると、ハンドル値が無効かどうかを示す値を取得します。

参照

関連項目

CriticalHandle クラス
System.Runtime.InteropServices 名前空間
SafeHandle
Microsoft.Win32.SafeHandles

CriticalHandle メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	リソースを解放するようにハンドルにマークを付けます。
	Dispose	オーバーロードされます。 リソースを解放するようにハンドルにマークを付けます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetHandleAsInvalid	ハンドルを無効としてマークします。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 リソースを解放するようにハンドルにマークを付けます。
	Finalize	オーバーライドされます。 ハンドルに関連付けられたすべてのリソースを解放します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	ReleaseHandle	派生クラスでオーバーライドされると、ハンドルを解放するために必要なコードを実行します。
	SetHandle	ハンドルを、指定した既存のハンドルに設定します。

参照

関連項目

CriticalHandle クラス
System.Runtime.InteropServices 名前空間
SafeHandle
Microsoft.Win32.SafeHandles

CriticalHandle メンバ

ハンドル リソースのラッパー クラスを表します。

CriticalHandle データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	CriticalHandle	指定した無効なハンドル値を使用して、CriticalHandle クラスの新しいインスタンスを初期化します。

プロテクト フィールド

	名前	説明
	handle	ラップされるハンドルを指定します。

パブリック プロパティ

	名前	説明
	IsClosed	ハンドルが閉じているかどうかを示す値を取得します。
	IsInvalid	派生クラスでオーバーライドされると、ハンドル値が無効かどうかを示す値を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	リソースを解放するようにハンドルにマークを付けます。
	Dispose	オーバーロードされます。 リソースを解放するようにハンドルにマークを付けます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetHandleAsInvalid	ハンドルを無効としてマークします。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 リソースを解放するようにハンドルにマークを付けます。
	Finalize	オーバーライドされます。 ハンドルに関連付けられたすべてのリソースを解放します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	ReleaseHandle	派生クラスでオーバーライドされると、ハンドルを解放するために必要なコードを実行します。
	SetHandle	ハンドルを、指定した既存のハンドルに設定します。

参照

関連項目

CriticalHandle クラス
System.Runtime.InteropServices 名前空間
SafeHandle
Microsoft.Win32.SafeHandles