SafeHandleZeroOrMinusOneIsInvalid 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供基底類別 (Base Class) 給 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。 例如，) 檔案或登錄句柄 (進一步衍生這個類別可以進一步特製化。 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) |
