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