SafeHandle.DangerousAddRef(Boolean) Método
Definição
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.
Incrementa manualmente o contador de referências em instâncias do SafeHandle.
public:
void DangerousAddRef(bool % success);[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);public void DangerousAddRef (ref bool success);[<System.Security.SecurityCritical>]
member this.DangerousAddRef : bool -> unitmember this.DangerousAddRef : bool -> unitPublic Sub DangerousAddRef (ByRef success As Boolean)Parâmetros
- success
- Boolean
true se o contador de referências tiver sido aumentado com êxito; caso contrário, false.
- Atributos
Exceções
O SafeHandle foi descartado.
Comentários
O DangerousAddRef método impede que o Common Language Runtime recupere a memória usada por um identificador (que ocorre quando o runtime chama o ReleaseHandle método). Você pode usar esse método para incrementar manualmente a contagem de referência em uma SafeHandle instância.
DangerousAddRef retorna um valor booliano usando um ref parâmetro (success) que indica se a contagem de referência foi incrementada com êxito. Isso permite que a lógica do programa faça backup em caso de falha. Você deve definir success como false antes de chamar DangerousAddRef. Se success for true, evite vazamentos de recursos correspondendo a chamada a DangerousAddRef com uma chamada correspondente para DangerousRelease.
Se essa chamada for bem-sucedida, ela definirá o ref bool success parâmetro como true e retornará com êxito. Se essa chamada não for bem-sucedida, ela gerará uma exceção e deixará o ref bool success parâmetro inalterado.
