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 -> unitmember this.DangerousAddRef : bool -> unitPublic Sub DangerousAddRef (ByRef success As Boolean)- success
- Boolean
参照カウンターが正常にインクリメントされた場合は true。それ以外の場合は false。
- 属性
SafeHandle が破棄されました。
メソッドは DangerousAddRef 、共通言語ランタイムがハンドルによって使用されるメモリを再利用できないようにします (ランタイムが メソッドを呼び出すときに ReleaseHandle 発生します)。 このメソッドを使用すると、インスタンスの参照カウントを手動で SafeHandle インクリメントできます。
DangerousAddRef は、参照カウントが正常に ref インクリメントされたかどうかを示すパラメーター (success) を使用してブール値を返します。 これにより、エラーが発生した場合にプログラム ロジックをバックアウトできます。 を呼び出すDangerousAddRef前に を にfalse設定successする必要があります。 が の場合 success は true、 の呼び出しと に対応する の呼び出し DangerousAddRef を照合することで、リソース リークを DangerousRelease回避します。
この呼び出しが成功すると、 パラメーターが ref bool success に true 設定され、正常に返されます。 この呼び出しが失敗した場合、例外がスローされ、 パラメーターは ref bool success 変更されません。
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。