SafeHandleZeroOrMinusOneIsInvalid Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje základní třídu pro win32 bezpečné popisovače implementace, ve které hodnota 0 nebo -1 označuje neplatný popisovač.
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- Dědičnost
- Odvozené
- Atributy
Poznámky
Tato třída je odvozena od System.Runtime.InteropServices.SafeHandle třídy. Popisuje formát neplatného popisovače. Některé popisovače například používají hodnotu -1 jako neplatnou hodnotu popisovače, zatímco jiné používají hodnotu 0. Další odvození této třídy (například popisovače souborů nebo registru) se na to mohou dále specializovat. SafeFileHandle Příklad třídy, která je odvozena z , najdete v SafeHandleZeroOrMinusOneIsInvalidtřídě .
Důležité
Tento typ implementuje IDisposable rozhraní. Po dokončení používání tohoto typu byste ho měli přímo nebo nepřímo odstranit. Pokud chcete odstranit typ přímo, zavolejte jeho Dispose metodu try/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, například using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace najdete v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.
SafeHandleZeroOrMinusOneIsInvalid Použijte třídu vždy, když potřebujete bezpečně zabalit nespravovaný prostředek, který nemá existující spravovanou obálku.
Konstruktory
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Inicializuje novou instanci SafeHandleZeroOrMinusOneIsInvalid třídy, určuje, zda má být popisovač spolehlivě uvolněn. |
Pole
| handle |
Určuje popisovač, který se má zabalit. (Zděděno od SafeHandle) |
Vlastnosti
| IsClosed |
Získá hodnotu označující, zda je popisovač uzavřen. (Zděděno od SafeHandle) |
| IsInvalid |
Získá hodnotu, která označuje, zda popisovač je neplatný. |
Metody
| Close() |
Označí popisovač pro uvolnění a uvolnění prostředků. (Zděděno od SafeHandle) |
| DangerousAddRef(Boolean) |
Ručně zvýší čítač odkazů na SafeHandle instance. (Zděděno od SafeHandle) |
| DangerousGetHandle() |
Vrátí hodnotu handle pole. (Zděděno od SafeHandle) |
| DangerousRelease() |
Ručně sníží čítač odkazů na SafeHandle instanci. (Zděděno od SafeHandle) |
| Dispose() |
Uvolní všechny prostředky používané SafeHandle třídou. (Zděděno od SafeHandle) |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané SafeHandle třídou určující, zda se má provést normální operace dispose. (Zděděno od SafeHandle) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| ReleaseHandle() |
Při přepsání v odvozené třídě spustí kód potřebný k uvolnění popisovače. (Zděděno od SafeHandle) |
| SetHandle(IntPtr) |
Nastaví popisovač na zadaný již existující popisovač. (Zděděno od SafeHandle) |
| SetHandleAsInvalid() |
Označí úchyt jako nepoužívaný. (Zděděno od SafeHandle) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
