SafeHandleMinusOneIsInvalid Класс

Определение

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

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

Комментарии

Этот класс является производным от класса System.Runtime.InteropServices.SafeHandle.This class derives from the System.Runtime.InteropServices.SafeHandle class. Он описывает формат недопустимого маркера, который использует значение-1.It describes the format of an invalid handle that uses a value of -1. Дальнейшие порождение этого класса (например, дескрипторов файлов или реестра) может быть более подробно.Further derivations of this class (for example, file or registry handles) can specialize this further. Пример класса SafeFileHandle , производного от SafeHandleMinusOneIsInvalid, см. в классе.See the SafeFileHandle class for an example of a class that derives from SafeHandleMinusOneIsInvalid.

Предупреждение

Этот тип реализует интерфейс 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.

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

SafeHandleMinusOneIsInvalid(Boolean)

Инициализирует новый экземпляр класса SafeHandleMinusOneIsInvalid, указывающий, нужно ли освобождать дескриптор наверняка.Initializes a new instance of the SafeHandleMinusOneIsInvalid class, specifying whether the handle is to be reliably released.

Поля

handle

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

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

Свойства

IsClosed

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

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

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

Методы

Close()

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

(Унаследовано от SafeHandle)
DangerousAddRef(Boolean)

Вручную увеличивает счетчик ссылок для экземпляров SafeHandle.Manually increments the reference counter on SafeHandle instances.

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

Возвращает значение поля handle.Returns the value of the handle field.

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

Вручную уменьшает счетчик ссылок для экземпляра SafeHandle.Manually decrements the reference counter on a SafeHandle instance.

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

Освобождает все ресурсы, используемые классом SafeHandle.Releases all resources used by the SafeHandle class.

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

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

(Унаследовано от SafeHandle)
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.

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

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

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

Помечает дескриптор, как больше не используемый.Marks a handle as no longer used.

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

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

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

Безопасность

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

SecurityCriticalAttribute
требуется полное доверие для немедленного вызывающего объекта.requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

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

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