SafeHandle.DangerousAddRef(Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Aumenta manualmente el recuento de referencias en instancias de 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
si el contador de referencia se incrementó correctamente; en caso contrario, false
.
- Atributos
Comentarios
El DangerousAddRef método impide que Common Language Runtime recupere la memoria usada por un identificador (que se produce cuando el tiempo de ejecución llama al ReleaseHandle método ). Puede usar este método para incrementar manualmente el recuento de referencias en una SafeHandle instancia de . DangerousAddRef devuelve un valor booleano mediante un ref
parámetro (success
) que indica si el recuento de referencias se incrementó correctamente. Esto permite que la lógica del programa vuelva a salir en caso de error. Debe establecer en success
false
antes de llamar a DangerousAddRef. Si success
es true
, evite pérdidas de recursos mediante la coincidencia de la llamada a DangerousAddRef con una llamada correspondiente a DangerousRelease.
Precaución
Este método está pensado para usuarios avanzados y siempre debe usarse cuidadosamente. Para evitar la pérdida de recursos de control, llame siempre a este método dentro de una región de ejecución restringida (CER), donde una anulación de subprocesos no puede interrumpir el procesamiento.