CriticalHandleZeroOrMinusOneIsInvalid Класс

Определение

Предоставляет базовый класс для реализаций критического дескриптора Win32, в котором значение 0 или -1 обозначает недопустимый дескриптор.Provides a base class for Win32 critical handle implementations in which the value of either 0 or -1 indicates an invalid handle.

public ref class CriticalHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::CriticalHandle
[System.Security.SecurityCritical]
public abstract class CriticalHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.CriticalHandle
public abstract class CriticalHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.CriticalHandle
type CriticalHandleZeroOrMinusOneIsInvalid = class
    inherit CriticalHandle
Public MustInherit Class CriticalHandleZeroOrMinusOneIsInvalid
Inherits CriticalHandle
Наследование
CriticalHandleZeroOrMinusOneIsInvalid
Наследование
CriticalHandleZeroOrMinusOneIsInvalid
Атрибуты

Комментарии

Этот класс является производным от класса System.Runtime.InteropServices.CriticalHandle.This class derives from the System.Runtime.InteropServices.CriticalHandle class. Он описывает формат недопустимого маркера.It describes the format of an invalid handle. Например, некоторые дескрипторы используют значение-1 в качестве недопустимого значения дескриптора, а другие используют 0.For example, some handles use -1 as an invalid handle value, while others use 0. Дальнейшие порождение этого класса (например, дескрипторов файлов или реестра) может быть более подробно.Further derivations of this class (for example, file or registry handles) can specialize this further.

Используйте класс CriticalHandleZeroOrMinusOneIsInvalid, если требуется заключить неуправляемый ресурс, который не имеет существующей управляемой оболочки.Use the CriticalHandleZeroOrMinusOneIsInvalid class when you need to wrap an unmanaged resource that does not have an existing managed wrapper.

Этот тип реализует интерфейс IDisposable.This type implements the IDisposable interface. По окончании использования выдаленную ему память следует прямо или косвенно освободить.When you have finished using the type, you should dispose of it either directly or indirectly. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Примечание

Важные сведения о безопасности критического обработчика и потокобезопасности см. в описании класса CriticalHandle.See the CriticalHandle class for important information on critical handle security and thread safety.

Конструкторы

CriticalHandleZeroOrMinusOneIsInvalid()

Инициализация нового экземпляра класса CriticalHandleZeroOrMinusOneIsInvalid.Initializes a new instance of the CriticalHandleZeroOrMinusOneIsInvalid class.

Поля

handle

Определяет инкапсулируемый дескриптор.Specifies the handle to be wrapped.

(Унаследовано от CriticalHandle)

Свойства

IsClosed

Возвращает значение, показывающее, является ли дескриптор закрытым.Gets a value indicating whether the handle is closed.

(Унаследовано от CriticalHandle)
IsInvalid

Получает значение, указывающее, является ли дескриптор недействительным.Gets a value that indicates whether the handle is invalid.

Методы

Close()

Помечает дескриптор для освобождения самого дескриптора и соответствующих ресурсов.Marks the handle for releasing and freeing resources.

(Унаследовано от CriticalHandle)
Dispose()

Освобождает все ресурсы, занятые CriticalHandle.Releases all resources used by the CriticalHandle.

(Унаследовано от CriticalHandle)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые классом CriticalHandle, определяя, нужно ли выполнять обычную операцию удаления.Releases the unmanaged resources used by the CriticalHandle class specifying whether to perform a normal dispose operation.

(Унаследовано от CriticalHandle)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ReleaseHandle()

При переопределении в производном классе выполняет код, необходимый для освобождения дескриптора.When overridden in a derived class, executes the code required to free the handle.

(Унаследовано от CriticalHandle)
SetHandle(IntPtr)

Определяет дескриптор для заданного ранее существующего дескриптора.Sets the handle to the specified pre-existing handle.

(Унаследовано от CriticalHandle)
SetHandleAsInvalid()

Помечает дескриптор как недопустимый.Marks a handle as invalid.

(Унаследовано от CriticalHandle)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно