SafeHandle.DangerousAddRef(Boolean) Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.dll

Source:

SafeHandle.cs

Aumenta manualmente el recuento de referencias en instancias de SafeHandle.

public:
 void DangerousAddRef(bool % success);

public void DangerousAddRef (ref bool success);

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.

Excepciones

ObjectDisposedException

El SafeHandle se ha eliminado.

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

Si esta llamada se realiza correctamente, establecerá el ref bool success parámetro true en y devolverá correctamente. Si esta llamada no se realiza correctamente, producirá una excepción y dejará el ref bool success parámetro sin modificar.

Consulte también

• DangerousRelease()