SafeHandleZeroOrMinusOneIsInvalid Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan kelas dasar untuk implementasi handel aman Win32 di mana nilai 0 atau -1 menunjukkan handel yang tidak valid.
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
- Warisan
- Turunan
- Atribut
Keterangan
Kelas ini berasal dari System.Runtime.InteropServices.SafeHandle kelas . Ini menjelaskan format handel yang tidak valid. Misalnya, beberapa handel menggunakan -1 sebagai nilai handel yang tidak valid, sementara yang lain menggunakan 0. Derivasi lebih lanjut dari kelas ini (misalnya, handel file atau registri) dapat mengkhasanakan ini lebih lanjut. SafeFileHandle Lihat kelas untuk contoh kelas yang berasal dari SafeHandleZeroOrMinusOneIsInvalid.
Penting
Jenis ini mengimplementasikan IDisposable antarmuka. Ketika Anda telah selesai menggunakan jenis , Anda harus membuangnya baik secara langsung atau tidak langsung. Untuk membuang jenis secara langsung, panggil metodenya Dispose dalam try
/catch
blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using
(dalam C#) atau Using
(di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" dalam IDisposable topik antarmuka.
SafeHandleZeroOrMinusOneIsInvalid Gunakan kelas setiap kali Anda perlu membungkus sumber daya yang tidak terkelola dengan aman yang tidak memiliki pembungkus terkelola yang ada.
Konstruktor
SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Menginisialisasi instans SafeHandleZeroOrMinusOneIsInvalid baru kelas, menentukan apakah handel akan dirilis dengan andal. |
Bidang
handle |
Menentukan handel yang akan dibungkus. (Diperoleh dari SafeHandle) |
Properti
IsClosed |
Mendapatkan nilai yang menunjukkan apakah handel ditutup. (Diperoleh dari SafeHandle) |
IsInvalid |
Mendapatkan nilai yang menunjukkan apakah handel tidak valid. |
Metode
Close() |
Menandai handel untuk melepaskan dan membebaskan sumber daya. (Diperoleh dari SafeHandle) |
DangerousAddRef(Boolean) |
Secara manual menaikkan penghitung referensi pada SafeHandle instans. (Diperoleh dari SafeHandle) |
DangerousGetHandle() |
Mengembalikan nilai handle bidang. (Diperoleh dari SafeHandle) |
DangerousRelease() |
Menurunkan penghitung referensi secara manual pada SafeHandle instans. (Diperoleh dari SafeHandle) |
Dispose() |
Merilis semua sumber daya yang SafeHandle digunakan oleh kelas . (Diperoleh dari SafeHandle) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang SafeHandle digunakan oleh kelas yang menentukan apakah akan melakukan operasi pembuangan normal. (Diperoleh dari SafeHandle) |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
ReleaseHandle() |
Ketika ditimpa di kelas turunan, jalankan kode yang diperlukan untuk membebaskan handel. (Diperoleh dari SafeHandle) |
SetHandle(IntPtr) |
Mengatur handel ke handel yang sudah ada sebelumnya yang ditentukan. (Diperoleh dari SafeHandle) |
SetHandleAsInvalid() |
Menandai handel sebagai tidak lagi digunakan. (Diperoleh dari SafeHandle) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |