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 -> unitmember this.DangerousAddRef : bool -> unitPublic Sub DangerousAddRef (ByRef success As Boolean)Parámetros
- success
- Boolean
true si el contador de referencia se incrementó correctamente; en caso contrario, false.
- Atributos
Excepciones
Se ha eliminado SafeHandle.
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 se devuelva 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 se devolverá correctamente. Si esta llamada no se realiza correctamente, producirá una excepción y dejará el ref bool success parámetro sin modificar.
