Compartilhar via


SafeHandle.DangerousAddRef(Boolean) Método

Definição

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 -> unit
member this.DangerousAddRef : bool -> unit
Public 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.

Aplica-se a

Confira também