SafeHandleZeroOrMinusOneIsInvalid クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Win32 セーフ ハンドル実装の基底クラスを提供します。この実装では、0 または -1 のいずれかの値が無効なハンドルを示します。
public ref class SafeHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandlepublic abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandletype SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandlePublic MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle- 継承
- 派生
- 属性
注釈
このクラスは System.Runtime.InteropServices.SafeHandle クラスから派生したクラスです。 無効なハンドルの形式について説明します。 たとえば、無効なハンドル値として -1 を使用するハンドルもあれば、0 を使用するハンドルもあります。 このクラスのさらに派生 (ファイルハンドルやレジストリ ハンドルなど) は、これをさらに特殊化できます。 SafeHandleZeroOrMinusOneIsInvalidから派生するクラスの例については、SafeFileHandle クラスを参照してください。
Important
この型は、IDisposable インターフェイスを実装します。 型の使用が完了したら、直接または間接的に破棄する必要があります。 型を直接破棄するには、Disposetry/ ブロックでその catch メソッドを呼び出します。 間接的に破棄するには、using (C#) や Using (Visual Basic) などの言語コンストラクトを使用します。 詳細については、 IDisposable インターフェイスのトピックの「IDisposable を実装するオブジェクトの使用」セクションを参照してください。
既存のマネージド ラッパーを持たないアンマネージ リソースを安全にラップする必要がある場合は常に、 SafeHandleZeroOrMinusOneIsInvalid クラスを使用します。
コンストラクター
| 名前 | 説明 |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
ハンドルを確実に解放するかどうかを指定して、 SafeHandleZeroOrMinusOneIsInvalid クラスの新しいインスタンスを初期化します。 |
フィールド
| 名前 | 説明 |
|---|---|
| handle |
ラップするハンドルを指定します。 (継承元 SafeHandle) |
プロパティ
| 名前 | 説明 |
|---|---|
| IsClosed |
ハンドルが閉じているかどうかを示す値を取得します。 (継承元 SafeHandle) |
| IsInvalid |
ハンドルが無効かどうかを示す値を取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Close() |
リソースを解放および解放するためのハンドルをマークします。 (継承元 SafeHandle) |
| DangerousAddRef(Boolean) |
SafeHandleインスタンスの参照カウンターを手動でインクリメントします。 (継承元 SafeHandle) |
| DangerousGetHandle() |
handle フィールドの値を返します。 (継承元 SafeHandle) |
| DangerousRelease() |
SafeHandle インスタンスの参照カウンターを手動でデクリメントします。 (継承元 SafeHandle) |
| Dispose() |
SafeHandle クラスによって使用されるすべてのリソースを解放します。 (継承元 SafeHandle) |
| Dispose(Boolean) |
通常の破棄操作を実行するかどうかを指定する、 SafeHandle クラスによって使用されるアンマネージ リソースを解放します。 (継承元 SafeHandle) |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| ReleaseHandle() |
派生クラスでオーバーライドされると、ハンドルを解放するために必要なコードを実行します。 (継承元 SafeHandle) |
| SetHandle(IntPtr) |
指定した既存のハンドルにハンドルを設定します。 (継承元 SafeHandle) |
| SetHandleAsInvalid() |
ハンドルを使用しなくなったものとしてマークします。 (継承元 SafeHandle) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |