SafeHandle.DangerousAddRef(Boolean) Метод

Определение

Вручную увеличивает счетчик ссылок для экземпляров SafeHandle.Manually increments the reference counter on SafeHandle instances.

public:
 void DangerousAddRef(bool % success);
public void DangerousAddRef (ref bool success);
[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);
member this.DangerousAddRef : bool -> unit
[<System.Security.SecurityCritical>]
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

Параметры

success
Boolean

Значение true, если счетчик ссылок был успешно увеличен; в противном случае — значение false.true if the reference counter was successfully incremented; otherwise, false.

Атрибуты

Комментарии

DangerousAddRefМетод не позволяет среде CLR высвободить память, используемую маркером (что происходит, когда среда выполнения вызывает ReleaseHandle метод).The DangerousAddRef method prevents the common language runtime from reclaiming memory used by a handle (which occurs when the runtime calls the ReleaseHandle method). Этот метод можно использовать для ручного увеличения счетчика ссылок на SafeHandle экземпляре.You can use this method to manually increment the reference count on a SafeHandle instance. DangerousAddRef Возвращает логическое значение с помощью ref параметра ( success ), который указывает, успешно ли был увеличен счетчик ссылок.DangerousAddRef returns a Boolean value using a ref parameter (success) that indicates whether the reference count was incremented successfully. Это позволяет выполнить логику программы в случае сбоя.This allows your program logic to back out in case of failure. success false Перед вызовом необходимо задать значение DangerousAddRef .You should set success to false before calling DangerousAddRef. Если success имеет значение true , избегайте утечки ресурсов путем сопоставления вызова DangerousAddRef с с соответствующим вызовом DangerousRelease .If success is true, avoid resource leaks by matching the call to DangerousAddRef with a corresponding call to DangerousRelease.

Внимание!

Этот метод предназначен для опытных пользователей и всегда должен использоваться аккуратно.This method is intended for advanced users and must always be used carefully. Чтобы избежать утечки ресурсов обработки, всегда вызывайте этот метод в области ограниченного выполнения (CER), где прерывание потока не может прервать обработку.To avoid leaking handle resources, always call this method inside a constrained execution region (CER), where a thread abort cannot interrupt processing.

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

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