SafeRegistryHandle Classe

Referência

Definição

Namespace:: Microsoft.Win32.SafeHandles

Assembly:: Microsoft.Win32.Registry.dll

Assembly:: mscorlib.dll

Origem:: SafeRegistryHandle.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

CriticalFinalizerObject

SafeHandle

SafeHandleZeroOrMinusOneIsInvalid
SafeRegistryHandle

Herança: Object

SafeHandle
SafeRegistryHandle

Atributos: SecurityCriticalAttribute

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

Compartilhar via