SafeHandle.DangerousAddRef(Boolean) Method

Definition

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

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

Parameters

success
Boolean

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

Attributes

Remarks

Метод 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. Перед вызовом DangerousAddRefнеобходимо задать false success.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.

Caution

Этот метод предназначен для опытных пользователей и всегда должен использоваться аккуратно.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.

Applies to

See also