SafeRegistryHandle SafeRegistryHandle SafeRegistryHandle SafeRegistryHandle Class

Definição

Representa um identificador seguro para o Registro do Windows.Represents a safe handle to the Windows registry.

public ref class SafeRegistryHandle sealed : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid
[System.Security.SecurityCritical]
public sealed class SafeRegistryHandle : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid
type SafeRegistryHandle = class
    inherit SafeHandleZeroOrMinusOneIsInvalid
Public NotInheritable Class SafeRegistryHandle
Inherits SafeHandleZeroOrMinusOneIsInvalid
Herança
Atributos

Comentários

Você pode usar a plataforma invocar em nativo RegCreateKeyEx função do Windows para obter uma SafeRegistryHandle do objeto e, em seguida, usá-lo para criar chaves de registro com o RegistryKey.FromHandle método.You can use platform invoke on the native RegCreateKeyEx Windows function to obtain a SafeRegistryHandle object, and then use it to create registry keys with the RegistryKey.FromHandle method.

Importante

Esse tipo implementa o IDisposable interface.This type implements the IDisposable interface. Quando você terminar de usar o tipo, você deve descartá-lo diretamente ou indiretamente.When you have finished using the type, you should dispose of it either directly or indirectly. Para descartar o tipo diretamente, chame seu Dispose método em um try / catch bloco.To dispose of the type directly, call its Dispose method in a try/catch block. Para descartá-los indiretamente, usar uma construção de linguagem, como using (em C#) ou Using (no Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" o IDisposable tópico da interface.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Construtores

SafeRegistryHandle(IntPtr, Boolean) SafeRegistryHandle(IntPtr, Boolean) SafeRegistryHandle(IntPtr, Boolean) SafeRegistryHandle(IntPtr, Boolean)

Inicializa uma nova instância da classe SafeRegistryHandle.Initializes a new instance of the SafeRegistryHandle class.

Propriedades

IsClosed IsClosed IsClosed IsClosed

Obtém um valor que indica se o identificador está fechado.Gets a value indicating whether the handle is closed.

(Inherited from SafeHandle)
IsInvalid IsInvalid IsInvalid IsInvalid

Métodos

Close() Close() Close() Close()

Marca o identificador de liberação de recursos.Marks the handle for releasing and freeing resources.

(Inherited from SafeHandle)
DangerousAddRef(Boolean) DangerousAddRef(Boolean) DangerousAddRef(Boolean) DangerousAddRef(Boolean)

Incrementa manualmente o contador de referências em instâncias do SafeHandle.Manually increments the reference counter on SafeHandle instances.

(Inherited from SafeHandle)
DangerousGetHandle() DangerousGetHandle() DangerousGetHandle() DangerousGetHandle()

Retorna o valor do campo handle.Returns the value of the handle field.

(Inherited from SafeHandle)
DangerousRelease() DangerousRelease() DangerousRelease() DangerousRelease()

Diminui manualmente o contador de referência em uma instância SafeHandle.Manually decrements the reference counter on a SafeHandle instance.

(Inherited from SafeHandle)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pela classe SafeHandle.Releases all resources used by the SafeHandle class.

(Inherited from SafeHandle)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pela classe SafeHandle que especifica se deve executar uma operação de descarte normal.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

(Inherited from SafeHandle)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ReleaseHandle() ReleaseHandle() ReleaseHandle() ReleaseHandle()

Quando substituído em uma classe derivada, executa o código necessário para liberar o identificador.When overridden in a derived class, executes the code required to free the handle.

(Inherited from SafeHandle)
SetHandle(IntPtr) SetHandle(IntPtr) SetHandle(IntPtr) SetHandle(IntPtr)

Define o identificador para o identificador pré-existente especificado.Sets the handle to the specified pre-existing handle.

(Inherited from SafeHandle)
SetHandleAsInvalid() SetHandleAsInvalid() SetHandleAsInvalid() SetHandleAsInvalid()

Marca um identificador como não mais usado.Marks a handle as no longer used.

(Inherited from SafeHandle)
ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Campos

handle handle handle handle

Especifica o identificador a ser encapsulado.Specifies the handle to be wrapped.

(Inherited from SafeHandle)

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a