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 -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

参数

success
Boolean

如果成功递增引用计数器,则为 true;否则为 false

属性

例外

SafeHandle 已释放。

注解

方法 DangerousAddRef 可防止公共语言运行时回收句柄使用的内存, (运行时) 调用 ReleaseHandle 该方法时发生。 可以使用此方法手动递增实例上的 SafeHandle 引用计数。 DangerousAddRef使用参数 (success) 返回一个ref布尔值,该参数指示引用计数是否已成功递增。 这样,程序逻辑就可以在发生故障时退出。 在调用 DangerousAddRef之前,应将 false 设置为 success 。 如果 successtrue,则通过将 对 DangerousAddRef 的调用与相应的调用 DangerousRelease匹配来避免资源泄漏。

如果此调用成功,它将将 ref bool success 参数 true 设置为 并成功返回。 如果此调用不成功,它将引发异常,并使 ref bool success 参数保持未修改状态。

适用于

另请参阅