SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) SafeHandle.DangerousAddRef(Boolean) Method

Definición

Aumenta manualmente el recuento de referencias en instancias de SafeHandle.Manually increments the reference counter on SafeHandle instances.

public:
 void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

Parámetros

success
Boolean Boolean Boolean Boolean

Es true si se ha aumentado correctamente el recuento de referencias; en caso contrario, es false.true if the reference counter was successfully incremented; otherwise, false.

Comentarios

El DangerousAddRef método impide que el Common Language Runtime recupere la memoria usada por un identificador (que se produce cuando el tiempo de ReleaseHandle ejecución llama al 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). Puede usar este método para incrementar manualmente el recuento de referencias en SafeHandle una instancia de.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRefDevuelve un valor booleano mediante un ref parámetro (success) que indica si el recuento de referencias se incrementó correctamente.DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. Esto permite que la lógica del programa retroceda en caso de error.This allows your program logic to back out in case of failure. Debe establecer success en antes false de llamar DangerousAddRefa.You should set success to false before calling DangerousAddRef. Si success DangerousAddRef DangerousReleasees true, evite las fugas de recursos coincidentes con la llamada a con la llamada correspondiente a.If success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

Precaución

Este método está pensado para usuarios avanzados y siempre debe usarse con cuidado.This method is intended for advanced users and must always be used carefully. Para evitar la pérdida de recursos de identificador, llame siempre a este método dentro de una región de ejecución restringida (CER), donde una anulación de subproceso no puede interrumpir el procesamiento.To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

Seguridad

SecurityPermission
para obtener permiso para llamar a código no administrado.for permission to call unmanaged code. Acción de seguridad LinkDemand:.Security action: LinkDemand. Enumeración asociada:UnmanagedCodeAssociated enumeration: UnmanagedCode

Se aplica a

Consulte también: