SafeHandle.DangerousAddRef(Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вручную увеличивает счетчик ссылок для экземпляров 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)Параметры
- success
- Boolean
Значение true, если счетчик ссылок был успешно увеличен; в противном случае — значение false.
- Атрибуты
Исключения
SafeHandle удален.
Комментарии
Метод DangerousAddRef не позволяет среде CLR освободить память, используемую дескриптором (которая возникает, когда среда выполнения вызывает ReleaseHandle метод ). Этот метод можно использовать для увеличения числа ссылок в экземпляре SafeHandle вручную.
DangerousAddRef возвращает логическое значение с помощью ref параметра (success), который указывает, был ли счетчик ссылок успешно увеличен. Это позволяет логике программы откатиться в случае сбоя. Перед вызовом DangerousAddRefнеобходимо присвоить false значение success . Если success имеет значение true, избегайте утечек ресурсов путем сопоставления вызова DangerousAddRef с соответствующим вызовом .DangerousRelease
Если этот вызов выполнен успешно, он установит ref bool success для параметра значение true и успешно возвратит. Если этот вызов не удается выполнить, будет выдано исключение и параметр останется ref bool success без изменений.
