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 執行個體上的參考計數器。

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

備註

方法 DangerousAddRef 可防止 Common Language Runtime 回收控制碼所使用的記憶體， (當執行時間呼叫 ReleaseHandle 方法) 時發生。 您可以使用這個方法來手動遞增實例上的 SafeHandle 參考計數。 DangerousAddRef 會傳回布林值，使用 ref 參數 (success) ，指出參考計數是否成功遞增。 這可讓您的程式邏輯在發生失敗時回復。 您應該先將 設定為 success ， false 再呼叫 DangerousAddRef 。 如果 success 為 true ，請藉由比對 對應呼叫 的 DangerousAddRef 呼叫 DangerousRelease 來避免資源流失。

警告

這個方法適用于進階使用者，必須一律謹慎使用。 若要避免資源外泄，請一律在限制的執列區域內呼叫此方法， (CER) ，其中線程中止無法中斷處理。

另請參閱

• DangerousRelease()