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 -> 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
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.