SafeHandleZeroOrMinusOneIsInvalid 類別

  • 參考

定義

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

提供基底類別 (Base Class) 給 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的類別範例，請參閱 類別。

重要

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

SafeHandleZeroOrMinusOneIsInvalid每當您需要安全地包裝沒有現有 Managed 包裝函式的 Unmanaged 資源時，請使用 類別。

建構函式

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 類別所使用的 Unmanaged 資源，指定是否要執行一般處置作業。

(繼承來源 SafeHandle)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ReleaseHandle()

在衍生類別中覆寫時，執行釋放控制代碼所需的程式碼。

(繼承來源 SafeHandle)
SetHandle(IntPtr)

將控制代碼設定為指定的既有控制代碼。

(繼承來源 SafeHandle)
SetHandleAsInvalid()

將控制代碼標記為不再使用。

(繼承來源 SafeHandle)
ToString()

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

(繼承來源 Object)

適用於

另請參閱