SafeHandleMinusOneIsInvalid 類別

定義

命名空間:

Microsoft.Win32.SafeHandles

組件:

netstandard.dll, System.Runtime.dll

來源:

SafeHandleMinusOneIsInvalid.cs

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

public ref class SafeHandleMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandle

public abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle

type SafeHandleMinusOneIsInvalid = class
    inherit SafeHandle

Public MustInherit Class SafeHandleMinusOneIsInvalid
Inherits SafeHandle

繼承

Object

CriticalFinalizerObject

SafeHandle

SafeHandleMinusOneIsInvalid

衍生

System.Net.Sockets.SafeSocketHandle

備註

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

警告

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

建構函式

名稱	Description
SafeHandleMinusOneIsInvalid(Boolean)	初始化該類別的新實例 SafeHandleMinusOneIsInvalid ，指定是否要可靠地釋放該句柄。

欄位

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

另請參閱

• SafeHandleZeroOrMinusOneIsInvalid
• CriticalHandleZeroOrMinusOneIsInvalid
• CriticalHandle
• SafeHandle