CA2006：使用 SafeHandle 封裝原生資源
型別名稱 |
UseSafeHandleToEncapsulateNativeResources |
CheckId |
CA2006 |
分類 |
Microsoft.Reliability |
中斷變更 |
中斷 |
原因
Managed 程式碼使用 IntPtr 存取原生資源。
規則描述
在 Managed 程式碼中使用 IntPtr 可能會有潛在的安全性和可靠性問題。對於 IntPtr 的所有使用情況，都必須檢閱以判斷是否需要在該處使用 SafeHandle 或類似技術。如果 IntPtr 代表某些應是 Managed 程式碼擁有的原生資源 (例如記憶體、檔案控制代碼或通訊端) 時，便會發生問題。如果 Managed 程式碼擁有資源，它也必須釋放與其相關聯的原生資源，因為若無法執行這項作業就會造成資源流失。
在這類案例中，如果允許對 IntPtr 進行多執行緒存取，而又提供釋放 IntPtr 所表示之資源的方法，也會存在安全性和可靠性問題。在另一個執行緒上正在使用資源的同時釋放該資源的情況下，這些問題牽涉到 IntPtr 值的回收。這可能會造成競爭條件，使其中一個執行緒可以讀取或寫入與錯誤資源相關聯的資料。例如，若您的型別將 OS 控制代碼儲存為 IntPtr，並且允許使用者使用該控制代碼同時呼叫 Close 和任何其他方法 (未經同步處理)，則您的程式碼會有控制代碼回收問題。
這個控制代碼回收問題可能導致資料損毀，並經常導致安全性弱點。SafeHandle 和其同層級類別 CriticalHandle 提供機制，將原生控制代碼封裝到資源，以便能夠避免這類執行緒的問題。此外，您還可以將 SafeHandle 及其同層級類別 CriticalHandle 用於處理其他執行緒問題，例如，對包含呼叫原生方法之原生控制代碼複本的 Managed 物件，小心控制它們的存留期 (Lifetime)。在此情況下，您通常可以移除對 GC.KeepAlive 的呼叫。當您使用 SafeHandle 時造成的效能負荷 (使用 CriticalHandle 的情況會稍微好一些)，通常可以透過小心設計來減輕。
如何修正違規
將 IntPtr 用法轉換成 SafeHandle，以便安全地管理原生資源的存取。如需範例，請參閱 SafeHandle 參考主題。
隱藏警告的時機
您不應該隱藏這項警告。