SafeHandle.DangerousAddRef(Boolean) 方法

定义

命名空间:

System.Runtime.InteropServices

程序集:

System.Runtime.dll

Source:

SafeHandle.cs

手动递增 SafeHandle 实例中的引用计数器。

public:
 void DangerousAddRef(bool % success);

public void DangerousAddRef (ref bool success);

member this.DangerousAddRef : bool -> unit

Public Sub DangerousAddRef (ByRef success As Boolean)

参数

success

Boolean

如果成功递增引用计数器，则为 true；否则为 false。

例外

ObjectDisposedException

SafeHandle 已释放。

注解

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

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

另请参阅

• DangerousRelease()