Sdílet prostřednictvím

SafeHandleZeroOrMinusOneIsInvalid Třída

  • Reference

Definice

Obor názvů:
Microsoft.Win32.SafeHandles
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
SafeHandleZeroOrMinusOneIsInvalid.cs
Zdroj:
SafeHandleZeroOrMinusOneIsInvalid.cs
Zdroj:
SafeHandleZeroOrMinusOneIsInvalid.cs

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::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
Dědičnost
Object
CriticalFinalizerObject
SafeHandle
SafeHandleZeroOrMinusOneIsInvalid
Odvozené
Atributy
SecurityCriticalAttribute

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)

Platí pro

Viz také