SafeHandle.DangerousAddRef(Boolean) Метод

  • Ссылка

Определение

Пространство имен:
System.Runtime.InteropServices
Сборки:
mscorlib.dll, System.Runtime.Handles.dll
Сборка:
System.Runtime.dll
Сборка:
System.Runtime.Handles.dll
Сборка:
mscorlib.dll
Сборка:
System.Runtime.InteropServices.dll
Сборка:
netstandard.dll
Исходный код:
SafeHandle.cs
Исходный код:
SafeHandle.cs
Исходный код:
SafeHandle.cs

Вручную увеличивает счетчик ссылок для экземпляров 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 -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

Параметры

success
Boolean

Значение true, если счетчик ссылок был успешно увеличен; в противном случае — значение false.

Атрибуты
SecurityCriticalAttribute

Исключения

ObjectDisposedException

SafeHandle удален.

Комментарии

Метод DangerousAddRef не позволяет среде CLR освободить память, используемую дескриптором (которая возникает, когда среда выполнения вызывает ReleaseHandle метод ). Этот метод можно использовать для увеличения числа ссылок в экземпляре SafeHandle вручную. DangerousAddRef возвращает логическое значение с помощью ref параметра (success), который указывает, был ли счетчик ссылок успешно увеличен. Это позволяет логике программы откатиться в случае сбоя. Перед вызовом DangerousAddRefнеобходимо присвоить false значение success . Если success имеет значение true, избегайте утечек ресурсов путем сопоставления вызова DangerousAddRef с соответствующим вызовом .DangerousRelease

Если этот вызов выполнен успешно, он установит ref bool success для параметра значение true и успешно возвратит. Если этот вызов не удается выполнить, будет выдано исключение и параметр останется ref bool success без изменений.

Применяется к

См. также раздел