SafeHandle.DangerousAddRef(Boolean) 方法

  • 參考

定義

命名空間:
System.Runtime.InteropServices
組件:
mscorlib.dll, System.Runtime.Handles.dll
組件:
System.Runtime.dll
組件:
System.Runtime.Handles.dll
組件:
mscorlib.dll
組件:
System.Runtime.InteropServices.dll
組件:
netstandard.dll
來源:
SafeHandle.cs
來源:
SafeHandle.cs
來源:
SafeHandle.cs

手動遞增 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。

屬性
SecurityCriticalAttribute

例外狀況

ObjectDisposedException

SafeHandle 已處置。

備註

方法 DangerousAddRef 可防止 Common Language Runtime 回收句柄所使用的記憶體， (當運行時間呼叫 ReleaseHandle 方法) 時發生。 您可以使用這個方法來手動遞增 實例上的 SafeHandle 參考計數。 DangerousAddRef 使用 ref 參數傳回布爾值 (success) ，指出參考計數是否成功遞增。 這可讓您的程式邏輯在發生失敗時回溯。 您應該在電話DangerousAddRef之前會設定success為 false 。 如果 success 為 true，請比對 與的對應呼叫DangerousAddRefDangerousRelease，以避免資源流失。

如果此呼叫成功，它會將 ref bool success 參數設定為 true ，並成功傳回。 如果此呼叫失敗，則會擲回例外狀況，並讓 ref bool success 參數保持未修改。

適用於

另請參閱