SafeRegistryHandle Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет безопасный дескриптор для реестра Windows.
public ref class SafeRegistryHandle sealed : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid
public ref class SafeRegistryHandle sealed : System::Runtime::InteropServices::SafeHandle
public sealed class SafeRegistryHandle : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid
[System.Security.SecurityCritical]
public sealed class SafeRegistryHandle : System.Runtime.InteropServices.SafeHandle
[System.Security.SecurityCritical]
public sealed class SafeRegistryHandle : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid
type SafeRegistryHandle = class
inherit SafeHandleZeroOrMinusOneIsInvalid
[<System.Security.SecurityCritical>]
type SafeRegistryHandle = class
inherit SafeHandle
[<System.Security.SecurityCritical>]
type SafeRegistryHandle = class
inherit SafeHandleZeroOrMinusOneIsInvalid
Public NotInheritable Class SafeRegistryHandle
Inherits SafeHandleZeroOrMinusOneIsInvalid
Public NotInheritable Class SafeRegistryHandle
Inherits SafeHandle
- Наследование
- Наследование
- Атрибуты
Комментарии
Для получения SafeRegistryHandle объекта можно использовать вызов платформы в собственной RegCreateKeyEx
функции Windows, а затем использовать его для создания разделов реестра с RegistryKey.FromHandle помощью метода .
Важно!
Этот тип реализует интерфейс IDisposable. По окончании использования выдаленную ему память следует прямо или косвенно освободить. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try
/catch
. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using
(в C#) или Using
(в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.
Конструкторы
SafeRegistryHandle() |
Создает объект SafeRegistryHandle. |
SafeRegistryHandle(IntPtr, Boolean) |
Инициализирует новый экземпляр класса SafeRegistryHandle. |
Поля
handle |
Определяет инкапсулируемый дескриптор. (Унаследовано от SafeHandle) |
Свойства
IsClosed |
Возвращает значение, показывающее, является ли дескриптор закрытым. (Унаследовано от SafeHandle) |
IsInvalid |
Получает значение, указывающее, является ли дескриптор недействительным. |
IsInvalid |
Получает значение, указывающее, является ли дескриптор недействительным. (Унаследовано от SafeHandleZeroOrMinusOneIsInvalid) |
Методы
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) |