SafeHandle.DangerousAddRef(Boolean) Метод

Определение

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

public:
 void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);
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.

Атрибуты

Комментарии

Метод не позволяет среде CLR высвободить память, используемую маркером (что происходит, когда среда выполнения ReleaseHandle вызывает метод). DangerousAddRefThe 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. false Перед success вызовом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.

Безопасность

SecurityPermission
разрешение на вызов неуправляемого кода.for permission to call unmanaged code. Действие по обеспечению безопасности: LinkDemand.Security action: LinkDemand. Связанное перечисление:UnmanagedCodeAssociated enumeration: UnmanagedCode

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

Дополнительно