SafeHandleMinusOneIsInvalid

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

SafeHandleMinusOneIsInvalid クラス

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

値 -1 が無効なハンドルである Win32 セーフ ハンドルの実装の基本クラスを提供します。

名前空間: Microsoft.Win32.SafeHandles
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public MustInherit Class
 SafeHandleMinusOneIsInvalid
    Inherits SafeHandle

Visual Basic (使用法)

Dim instance As SafeHandleMinusOneIsInvalid

C#

public abstract class SafeHandleMinusOneIsInvalid
 : SafeHandle

C++

public ref class SafeHandleMinusOneIsInvalid
 abstract : public SafeHandle

J#

public abstract class SafeHandleMinusOneIsInvalid
 extends SafeHandle

JScript

public abstract class SafeHandleMinusOneIsInvalid
 extends SafeHandle

解説

このクラスは System.Runtime.InteropServices.SafeHandle クラスから派生したクラスです。このクラスは、値 -1 を使用する無効なハンドルの形式を記述します。このクラスからさらにファイル ハンドルやレジストリ ハンドルなどへ派生して、さらなる特化が可能です。SafeHandleZeroOrMinusOneIsInvalid から派生したクラスの例については、SafeFileHandle クラスのトピックを参照してください。

継承階層

System.Object
   System.Runtime.ConstrainedExecution.CriticalFinalizerObject
     System.Runtime.InteropServices.SafeHandle
      Microsoft.Win32.SafeHandles.SafeHandleMinusOneIsInvalid

スレッド セーフ

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

参照

関連項目
SafeHandleMinusOneIsInvalid メンバ
Microsoft.Win32.SafeHandles 名前空間
SafeHandleZeroOrMinusOneIsInvalid
CriticalHandleZeroOrMinusOneIsInvalid クラス
CriticalHandle
SafeHandle

SafeHandleMinusOneIsInvalid コンストラクタ

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

SafeHandleMinusOneIsInvalid クラスの新しいインスタンスを初期化し、ハンドルを安全に解放するかどうかを指定します。

名前空間: Microsoft.Win32.SafeHandles
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    ownsHandle As Boolean _
)

Visual Basic (使用法)

Dim ownsHandle As Boolean

Dim instance As New SafeHandleMinusOneIsInvalid(ownsHandle)

C#

protected SafeHandleMinusOneIsInvalid (
    bool ownsHandle
)

C++

protected:
SafeHandleMinusOneIsInvalid (
    bool ownsHandle
)

J#

protected SafeHandleMinusOneIsInvalid (
    boolean ownsHandle
)

JScript

protected function SafeHandleMinusOneIsInvalid
 (
    ownsHandle : boolean
)

パラメータ

ownsHandle

終了処理中にハンドルを安全に解放する場合は true。安全な解放を行わない場合は false (お勧めしません)。

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

関連項目
SafeHandleMinusOneIsInvalid クラス
SafeHandleMinusOneIsInvalid メンバ
Microsoft.Win32.SafeHandles 名前空間
SafeHandle

SafeHandleMinusOneIsInvalid フィールド

プロテクト フィールド

	名前	説明
	handle	ラップするハンドルを指定します。 ( SafeHandle から継承されます。)

参照

関連項目

SafeHandleMinusOneIsInvalid クラス
Microsoft.Win32.SafeHandles 名前空間
SafeHandleZeroOrMinusOneIsInvalid
CriticalHandleZeroOrMinusOneIsInvalid クラス
CriticalHandle
SafeHandle

SafeHandleMinusOneIsInvalid プロパティ

パブリック プロパティ

	名前	説明
	IsClosed	ハンドルが閉じているかどうかを示す値を取得します。 ( SafeHandle から継承されます。)
	IsInvalid	オーバーライドされます。 ハンドルが無効かどうかを示す値を取得します。

参照

関連項目

SafeHandleMinusOneIsInvalid クラス
Microsoft.Win32.SafeHandles 名前空間
SafeHandleZeroOrMinusOneIsInvalid
CriticalHandleZeroOrMinusOneIsInvalid クラス
CriticalHandle
SafeHandle

SafeHandleMinusOneIsInvalid メソッド

パブリック メソッド

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

	名前	説明
	Close	リソースを解放するためのハンドルをマークします。 ( SafeHandle から継承されます。)
	DangerousAddRef	SafeHandle インスタンスの参照カウンタを手動でインクリメントします。 ( SafeHandle から継承されます。)
	DangerousGetHandle	handle フィールドの値を返します。 ( SafeHandle から継承されます。)
	DangerousRelease	SafeHandle インスタンスの参照カウンタを手動でデクリメントします。 ( SafeHandle から継承されます。)
	Dispose	オーバーロードされます。 SafeHandle クラスが使用しているリソースを解放します。 ( SafeHandle から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetHandleAsInvalid	今後は使用しないものとしてハンドルをマークします。 ( SafeHandle から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

SafeHandleMinusOneIsInvalid クラス
Microsoft.Win32.SafeHandles 名前空間
SafeHandleZeroOrMinusOneIsInvalid
CriticalHandleZeroOrMinusOneIsInvalid クラス
CriticalHandle
SafeHandle

SafeHandleMinusOneIsInvalid メンバ

値 -1 が無効なハンドルである Win32 セーフ ハンドルの実装の基本クラスを提供します。

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

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

	名前	説明
	SafeHandleMinusOneIsInvalid	SafeHandleMinusOneIsInvalid クラスの新しいインスタンスを初期化し、ハンドルを安全に解放するかどうかを指定します。

プロテクト フィールド

	名前	説明
	handle	ラップするハンドルを指定します。(SafeHandle から継承されます。)

パブリック プロパティ

	名前	説明
	IsClosed	ハンドルが閉じているかどうかを示す値を取得します。(SafeHandle から継承されます。)
	IsInvalid	オーバーライドされます。 ハンドルが無効かどうかを示す値を取得します。

パブリック メソッド

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

	名前	説明
	Close	リソースを解放するためのハンドルをマークします。 (SafeHandle から継承されます。)
	DangerousAddRef	SafeHandle インスタンスの参照カウンタを手動でインクリメントします。 (SafeHandle から継承されます。)
	DangerousGetHandle	handle フィールドの値を返します。 (SafeHandle から継承されます。)
	DangerousRelease	SafeHandle インスタンスの参照カウンタを手動でデクリメントします。 (SafeHandle から継承されます。)
	Dispose	オーバーロードされます。 SafeHandle クラスが使用しているリソースを解放します。 (SafeHandle から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetHandleAsInvalid	今後は使用しないものとしてハンドルをマークします。 (SafeHandle から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

SafeHandleMinusOneIsInvalid クラス
Microsoft.Win32.SafeHandles 名前空間
SafeHandleZeroOrMinusOneIsInvalid
CriticalHandleZeroOrMinusOneIsInvalid クラス
CriticalHandle
SafeHandle