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
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ências 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 para false antes de chamar DangerousAddRef. Se success for true, evite vazamentos de recursos correspondendo à DangerousAddRef chamada com uma chamada correspondente para DangerousRelease.
Cuidado
Esse método destina-se a usuários avançados e deve ser sempre usado com cuidado. Para evitar o vazamento de recursos do identificador, sempre chame esse método dentro de uma CER (região de execução restrita), em que uma anulação de thread não pode interromper o processamento.