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 :  -> 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 evita que common language runtime reclame memoria utilizada por un identificador (que se produce cuando el tiempo de ejecución llama a la 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). Puede usar este método aumentarás manualmente el recuento de referencias en un SafeHandle instancia.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRef Devuelve un valor booleano mediante un ref parámetro (success) que indica si el recuento de referencias se incrementa 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 hacia atrás en caso de error.This allows your program logic to back out in case of failure. Debe establecer success a false antes de llamar a DangerousAddRef.You should set success to false before calling DangerousAddRef. Si success es true, evitar pérdidas de recursos haciendo coincidir la llamada a DangerousAddRef con una llamada correspondiente a DangerousRelease.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 utilizarse con cuidado.This method is intended for advanced users and must always be used carefully. Para evitar la pérdida de los recursos de controlador, 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 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: