SafeHandleZeroOrMinusOneIsInvalid 類別

定義

命名空間:
Microsoft.Win32.SafeHandles
組件:
netstandard.dll, System.Runtime.dll
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
SafeHandleZeroOrMinusOneIsInvalid.cs
來源:
SafeHandleZeroOrMinusOneIsInvalid.cs
來源:
SafeHandleZeroOrMinusOneIsInvalid.cs
來源:
SafeHandleZeroOrMinusOneIsInvalid.cs
來源:
SafeHandleZeroOrMinusOneIsInvalid.cs

提供一個 Win32 安全句柄實作的基底類別，其中值 0 或 -1 表示無效的句柄。

public ref class SafeHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandle
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
[System.Security.SecurityCritical]
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
type SafeHandleZeroOrMinusOneIsInvalid = class
    inherit SafeHandle
[<System.Security.SecurityCritical>]
type SafeHandleZeroOrMinusOneIsInvalid = class
    inherit SafeHandle
Public MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle
繼承
Object
CriticalFinalizerObject
SafeHandle
SafeHandleZeroOrMinusOneIsInvalid
衍生
屬性
SecurityCriticalAttribute

備註

此類別衍生自 System.Runtime.InteropServices.SafeHandle 類別。 它描述了無效句柄的格式。 例如，有些句柄使用 -1 作為無效的句柄值，而有些則使用 0。 此類別的進一步衍生（例如檔案或登錄檔帳柄）可以進一步專門化此類別。 參見 該 SafeFileHandle 類別，以示由 SafeHandleZeroOrMinusOneIsInvalid衍生的類別。

Important

此類型會實作 IDisposable 介面。 當您完成使用這個物品後，應直接或間接地處理它。 若要直接處置類型，請在 Disposetry/ 區塊中呼叫其 catch 方法。 若要間接處置它，請使用語言建構，例如 using （C#） 或 Using （在 Visual Basic 中）。 如需詳細資訊，請參閱介面主題中的 <使用實作 IDisposable 的物件>一節。

每當你需要安全包裝一個沒有現有受管理包裝器的未管理資源時，就使用這個 SafeHandleZeroOrMinusOneIsInvalid 類別。

建構函式

名稱 Description
SafeHandleZeroOrMinusOneIsInvalid(Boolean)

初始化該類別的新實例 SafeHandleZeroOrMinusOneIsInvalid ，指定是否要可靠地釋放該句柄。

欄位

名稱 Description
handle

指定要包裹的把手。

(繼承來源 SafeHandle)

屬性

名稱 Description
IsClosed

會得到一個值，表示把柄是否已關閉。

(繼承來源 SafeHandle)
IsInvalid

會得到一個值，表示該句柄是否無效。

方法

名稱 Description
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()

當在衍生類別中覆寫時，會執行釋放 handle 所需的程式碼。

(繼承來源 SafeHandle)
SetHandle(IntPtr)

將 handle 設為指定的既存 handle。

(繼承來源 SafeHandle)
SetHandleAsInvalid()

標記一個不再使用的把手。

(繼承來源 SafeHandle)
ToString()

傳回表示目前 物件的字串。

(繼承來源 Object)

適用於

另請參閱