SafeHandle.DangerousAddRef(Boolean) Método
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.
Incrementa manualmente o contador de referência nas SafeHandle instâncias.
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ência foi incrementado com sucesso; caso contrário, false.
- Atributos
Exceções
O SafeHandle foi descartado.
Observações
O DangerousAddRef método impede que o runtime da linguagem comum recupere a memória usada por um handle (o que ocorre quando o runtime chama o ReleaseHandle método). Pode usar este método para incrementar manualmente a contagem de referências numa SafeHandle instância.
DangerousAddRef devolve um valor booleano usando um ref parâmetro (success) que indica se a contagem de referência foi incrementada com sucesso. Isto permite que a lógica do programa recue em caso de falha. Deves definir success para false antes de ligar DangerousAddRef. Se success for true, evite fugas de recursos ao associar a chamada a DangerousAddRef com uma chamada correspondente a DangerousRelease.
Se esta chamada for bem-sucedida, definirá o ref bool success parâmetro para true e retornará com sucesso. Se esta chamada não for bem-sucedida, lançará uma exceção e deixará o ref bool success parâmetro sem modificação.