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í.
Incrementa manualmente el contador de referencia en SafeHandle las instancias.
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; de lo contrario, false.
- Atributos
Excepciones
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, iniciará una excepción y dejará el ref bool success parámetro sin modificar.