SafeHandle.DangerousAddRef(Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
手动递增 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 -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)
参数
- success
- Boolean
如果成功递增引用计数器,则为 true
;否则为 false
。
- 属性
注解
该方法 DangerousAddRef 可防止公共语言运行时回收句柄使用的内存, (当运行时调用 ReleaseHandle 该方法) 时发生。 可以使用此方法手动递增实例上的 SafeHandle 引用计数。 DangerousAddRef 使用 ref
参数 () success
返回布尔值,该值指示引用计数是否已成功递增。 这样,程序逻辑就可以在发生故障时回退。 在调用DangerousAddRef之前,应设置为 。success
false
true
如果是success
,请通过将调用与相应的调用DangerousRelease匹配来DangerousAddRef避免资源泄漏。
注意
此方法适用于高级用户,必须始终谨慎使用。 为了避免泄漏处理资源,请始终在受约束的执行区域中调用此方法 (CER) ,其中线程中止无法中断处理。