SafeHandleZeroOrMinusOneIsInvalid Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет базовый класс для реализаций безопасных дескрипторов Win32, в которых значение 0 или -1 указывает недопустимый дескриптор.
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- Наследование
- Производный
- Атрибуты
Комментарии
Этот класс является производным от класса System.Runtime.InteropServices.SafeHandle. Он описывает формат недопустимого дескриптора. Например, некоторые дескрипторы используют -1 в качестве недопустимого значения дескриптора, а другие используют 0. Дальнейшие производные от этого класса (например, дескрипторы файлов или реестра) могут дополнительно специализируется на этом. См. SafeFileHandle пример класса, наследуемого от SafeHandleZeroOrMinusOneIsInvalid.
Important
Этот тип реализует IDisposable интерфейс. Завершив использование типа, следует избавиться от него напрямую или косвенно. Чтобы удалить тип напрямую, вызовите его Dispose метод в блоке try/catch . Чтобы удалить его косвенно, используйте конструкцию языка, например using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в IDisposable разделе интерфейса.
SafeHandleZeroOrMinusOneIsInvalid Используйте класс всякий раз, когда необходимо безопасно упаковать неуправляемый ресурс, который не имеет существующей управляемой оболочки.
Конструкторы
| Имя | Описание |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Инициализирует новый экземпляр SafeHandleZeroOrMinusOneIsInvalid класса, указывая, должен ли дескриптор быть надежно освобожден. |
Поля
| Имя | Описание |
|---|---|
| handle |
Указывает дескриптор, который необходимо упаковать. (Унаследовано от SafeHandle) |
Свойства
| Имя | Описание |
|---|---|
| IsClosed |
Возвращает значение, указывающее, закрыт ли дескриптор. (Унаследовано от SafeHandle) |
| IsInvalid |
Возвращает значение, указывающее, является ли дескриптор недопустимым. |
Методы
| Имя | Описание |
|---|---|
| Close() |
Помечает дескриптор для освобождения и освобождения ресурсов. (Унаследовано от SafeHandle) |
| DangerousAddRef(Boolean) |
Вручную увеличивает счетчик ссылок на SafeHandle экземпляры. (Унаследовано от SafeHandle) |
| DangerousGetHandle() |
Возвращает значение handle поля. (Унаследовано от SafeHandle) |
| DangerousRelease() |
Вручную уменьшает счетчик ссылок в экземпляре SafeHandle . (Унаследовано от SafeHandle) |
| Dispose() |
Освобождает все ресурсы, используемые классом SafeHandle . (Унаследовано от SafeHandle) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые SafeHandle классом, указывающим, следует ли выполнять обычную операцию удаления. (Унаследовано от SafeHandle) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ReleaseHandle() |
При переопределении в производном классе выполняет код, необходимый для освобождения дескриптора. (Унаследовано от SafeHandle) |
| SetHandle(IntPtr) |
Задает дескриптор указанному предварительно существующему дескриптору. (Унаследовано от SafeHandle) |
| SetHandleAsInvalid() |
Помечает дескриптор, который больше не используется. (Унаследовано от SafeHandle) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
