Compartilhar via


SafeRegistryHandle Classe

Definição

Representa um identificador seguro para o Registro do 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
Herança
Herança
SafeRegistryHandle
Atributos

Comentários

Você pode usar a invocação de plataforma na função nativa RegCreateKeyEx do Windows para obter um SafeRegistryHandle objeto e, em seguida, usá-lo para criar chaves do Registro com o RegistryKey.FromHandle método .

Importante

Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Construtores

SafeRegistryHandle()

Cria um SafeRegistryHandle.

SafeRegistryHandle(IntPtr, Boolean)

Inicializa uma nova instância da classe SafeRegistryHandle.

Campos

handle

Especifica o identificador a ser encapsulado.

(Herdado de SafeHandle)

Propriedades

IsClosed

Obtém um valor que indica se o identificador está fechado.

(Herdado de SafeHandle)
IsInvalid

Obtém um valor que indica se o identificador é inválido.

IsInvalid

Obtém um valor que indica se o identificador é inválido.

(Herdado de SafeHandleZeroOrMinusOneIsInvalid)

Métodos

Close()

Marca o identificador de liberação de recursos.

(Herdado de SafeHandle)
DangerousAddRef(Boolean)

Incrementa manualmente o contador de referências em instâncias do SafeHandle.

(Herdado de SafeHandle)
DangerousGetHandle()

Retorna o valor do campo handle.

(Herdado de SafeHandle)
DangerousRelease()

Diminui manualmente o contador de referência em uma instância SafeHandle.

(Herdado de SafeHandle)
Dispose()

Libera todos os recursos usados pela classe SafeHandle.

(Herdado de SafeHandle)
Dispose(Boolean)

Libera os recursos não gerenciados usados pela classe SafeHandle que especifica se deve executar uma operação de descarte normal.

(Herdado de SafeHandle)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ReleaseHandle()

Quando substituído em uma classe derivada, executa o código necessário para liberar o identificador.

(Herdado de SafeHandle)
SetHandle(IntPtr)

Define o identificador para o identificador pré-existente especificado.

(Herdado de SafeHandle)
SetHandleAsInvalid()

Marca um identificador como não mais usado.

(Herdado de SafeHandle)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a