SafeHandleZeroOrMinusOneIsInvalid Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma classe base para implementações de handles seguros Win32 em que o valor de 0 ou -1 indica um handle inválido.
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- Herança
- Derivado
- Atributos
Observações
Esta classe deriva da classe System.Runtime.InteropServices.SafeHandle. Descreve o formato de um handle inválido. Por exemplo, alguns handles usam -1 como valor de handle inválido, enquanto outros usam 0. Derivações adicionais desta classe (por exemplo, handles de ficheiros ou registos) podem especializar ainda mais esta situação. Veja a SafeFileHandle classe para um exemplo de uma classe que deriva de SafeHandleZeroOrMinusOneIsInvalid.
Importante
Este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deve eliminá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco try/catch. Para descartá-lo indiretamente, use uma construção de linguagem como using (em C#) ou Using (em Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" no tópico da IDisposable interface.
Usa a SafeHandleZeroOrMinusOneIsInvalid classe sempre que precisares de envolver de forma segura um recurso não gerido que não tenha um wrapper gerido existente.
Construtores
| Name | Description |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Inicializa uma nova instância da SafeHandleZeroOrMinusOneIsInvalid classe, especificando se o handle deve ser libertado de forma fiável. |
Campos
| Name | Description |
|---|---|
| handle |
Especifica o cabo a enrolar. (Herdado de SafeHandle) |
Propriedades
| Name | Description |
|---|---|
| IsClosed |
Obtém um valor que indica se a pega está fechada. (Herdado de SafeHandle) |
| IsInvalid |
Recebe um valor que indica se o handle é inválido. |
Métodos
| Name | Description |
|---|---|
| Close() |
Marca o nome para libertar e libertar recursos. (Herdado de SafeHandle) |
| DangerousAddRef(Boolean) |
Incrementa manualmente o contador de referência nas SafeHandle instâncias. (Herdado de SafeHandle) |
| DangerousGetHandle() |
Devolve o valor do handle campo. (Herdado de SafeHandle) |
| DangerousRelease() |
Decrementa manualmente o contador de referência numa SafeHandle instância. (Herdado de SafeHandle) |
| Dispose() |
Liberta todos os recursos usados pela SafeHandle turma. (Herdado de SafeHandle) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pela SafeHandle classe especificando se deve realizar uma operação normal de eliminação. (Herdado de SafeHandle) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ReleaseHandle() |
Quando sobrescrito numa classe derivada, executa o código necessário para libertar o handle. (Herdado de SafeHandle) |
| SetHandle(IntPtr) |
Define a alavanca para a alavanca pré-existente especificada. (Herdado de SafeHandle) |
| SetHandleAsInvalid() |
Marca uma pega como já não usada. (Herdado de SafeHandle) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |