SafeHandleMinusOneIsInvalid 類別

定義

命名空間:

Microsoft.Win32.SafeHandles

組件:

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 介面。 當您完成使用型別時，您應該直接或間接處置它。 若要直接處置型別，請呼叫其 try-catch 區塊中的 Dispose 方法。 若要間接處置它，請使用語言建構函式，例如 using (在 C# 中) 或 Using (在 Visual Basic 中)。 如需詳細資訊，請參閱 IDisposable 介面文章中的＜使用實作 IDisposable 的物件＞一節。

建構函式

SafeHandleMinusOneIsInvalid(Boolean)

初始化 SafeHandleMinusOneIsInvalid 類別的新執行個體，指定是否要確實地釋放控制代碼。

欄位

handle

指定要包裝的控制代碼。 (繼承來源 SafeHandle)

屬性

IsClosed	取得值，指出控制代碼是否已關閉。 (繼承來源 SafeHandle)
IsInvalid	取得值，表示控制代碼是否無效。

方法

Close()	標記要釋出和釋放資源的控制代碼。 (繼承來源 SafeHandle)
DangerousAddRef(Boolean)	手動遞增 SafeHandle 執行個體上的參考計數器。 (繼承來源 SafeHandle)
DangerousGetHandle()	傳回 handle 欄位的值。 (繼承來源 SafeHandle)
DangerousRelease()	手動遞減 SafeHandle 執行個體上的參考計數器。 (繼承來源 SafeHandle)
Dispose()	釋放 SafeHandle 類別所使用的所有資源。 (繼承來源 SafeHandle)
Dispose(Boolean)	釋放 SafeHandle 類別所使用的 Unmanaged 資源，指定是否要執行一般處置作業。 (繼承來源 SafeHandle)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ReleaseHandle()	在衍生類別中覆寫時，執行釋放控制代碼所需的程式碼。 (繼承來源 SafeHandle)
SetHandle(IntPtr)	將控制代碼設定為指定的既有控制代碼。 (繼承來源 SafeHandle)
SetHandleAsInvalid()	將控制代碼標記為不再使用。 (繼承來源 SafeHandle)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• SafeHandleZeroOrMinusOneIsInvalid
• CriticalHandleZeroOrMinusOneIsInvalid
• CriticalHandle
• SafeHandle