SafeHandle.DangerousAddRef(Boolean) Método

Definição

Incrementa manualmente o contador de referências em instâncias do SafeHandle.Manually increments the reference counter on SafeHandle instances.

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.true if the reference counter was successfully incremented; otherwise, false.

Atributos

Comentários

O DangerousAddRef método impede que a Common Language Runtime de recuperar a memória usada por um identificador (que ocorre quando o tempo de execução chama o ReleaseHandle método).The DangerousAddRef method prevents the common language runtime from reclaiming memory used by a handle (which occurs when the runtime calls the ReleaseHandle method). Você pode usar esse método para incrementar manualmente a contagem de referência em uma SafeHandle instância do.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRef Retorna um valor booliano usando um ref parâmetro ( success ) que indica se a contagem de referência foi incrementada com êxito.DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. Isso permite que a lógica do programa faça backup em caso de falha.This allows your program logic to back out in case of failure. Você deve definir success como false antes de chamar DangerousAddRef .You should set success to false before calling DangerousAddRef. Se success for true , evite vazamentos de recursos, correspondendo à chamada para DangerousAddRef com uma chamada correspondente para DangerousRelease .If success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

Cuidado

Esse método destina-se a usuários avançados e sempre deve ser usado com cuidado.This method is intended for advanced users and must always be used carefully. Para evitar vazamento de recursos de 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.To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

Aplica-se a

Confira também