CA2205: Win32 API에 있는 동일한 기능의 관리되는 항목을 사용하십시오.
TypeName |
UseManagedEquivalentsOfWin32Api |
CheckId |
CA2205 |
범주 |
Microsoft.Usage |
변경 수준 |
주요 변경 아님 |
원인
플랫폼 호출 메서드가 정의되었고 이와 동일한 기능을 수행하는 메서드가 .NET Framework 클래스 라이브러리에 있습니다.
규칙 설명
플랫폼 호출 메서드는 모든 관리되지 않는 DLL 함수의 호출에 사용되며 System.Runtime.InteropServices.DllImportAttribute 특성이나 Visual Basic의 Declare 키워드를 통해 정의됩니다. 잘못 정의된 플랫폼 호출 메서드는 이름이 잘못 지정된 함수, 매개 변수와 반환 값 데이터 형식의 잘못된 매핑, 올바르지 않은 필드 사양(예: 호출 규칙 및 문자 집합) 등의 문제로 인해 런타임 예외를 발생시킬 수 있습니다. 가능한 경우 관리되지 않는 메서드를 직접 정의하고 호출하는 것보다 동일한 기능의 관리되는 메서드를 호출하는 것이 일반적으로 더 간단하고 오류 발생 가능성도 더 낮습니다. 또한 플랫폼 호출 메서드를 호출하면 처리해야 할 추가적인 보안 문제가 발생할 수 있습니다.
위반 문제를 해결하는 방법
이 규칙 위반 문제를 해결하려면 관리되지 않는 함수에 대한 호출을 동일한 기능의 해당 관리 항목에 대한 호출로 바꾸십시오.
경고를 표시하지 않는 경우
제안된 대체 메서드가 필요한 기능을 제공하지 않을 경우에는 이 규칙에서 경고를 표시하지 마십시오.
예제
다음 예제에서는 이 규칙을 위반하는 플랫폼 호출 메서드 정의를 보여 줍니다. 또한 플랫폼 호출 메서드와 함께 동일한 기능의 관리되는 메서드에 대한 호출을 보여 줍니다.
Imports System
Imports System.Runtime.InteropServices
Imports System.Text
Namespace UsageLibrary
Class NativeMethods
Private Sub New()
End Sub
' The following method definitions violate the rule.
<DllImport("kernel32.dll", CharSet := CharSet.Unicode, _
SetLastError := True)> _
Friend Shared Function ExpandEnvironmentStrings _
(lpSrc As String, lpDst As StringBuilder, nSize As Integer) _
As Integer
End Function
Friend Declare Unicode Function ExpandEnvironmentStrings2 _
Lib "kernel32.dll" Alias "ExpandEnvironmentStrings" _
(lpSrc As String, lpDst As StringBuilder, nSize As Integer) _
As Integer
End Class
Public Class UseNativeMethod
Shared Sub Main()
Dim environmentVariable As String = "%TEMP%"
Dim expandedVariable As New StringBuilder(100)
' Call the unmanaged method.
NativeMethods.ExpandEnvironmentStrings( _
environmentVariable, _
expandedVariable, _
expandedVariable.Capacity)
' Call the unmanaged method.
NativeMethods.ExpandEnvironmentStrings2( _
environmentVariable, _
expandedVariable, _
expandedVariable.Capacity)
' Call the equivalent managed method.
Environment.ExpandEnvironmentVariables(environmentVariable)
End Sub
End Class
End Namespace
using System;
using System.Runtime.InteropServices;
using System.Text;
namespace UsageLibrary
{
internal class NativeMethods
{
private NativeMethods() {}
// The following method definition violates the rule.
[DllImport("kernel32.dll", CharSet = CharSet.Unicode,
SetLastError = true)]
internal static extern int ExpandEnvironmentStrings(
string lpSrc, StringBuilder lpDst, int nSize);
}
public class UseNativeMethod
{
public void Test()
{
string environmentVariable = "%TEMP%";
StringBuilder expandedVariable = new StringBuilder(100);
// Call the unmanaged method.
NativeMethods.ExpandEnvironmentStrings(
environmentVariable,
expandedVariable,
expandedVariable.Capacity);
// Call the equivalent managed method.
Environment.ExpandEnvironmentVariables(environmentVariable);
}
}
}
관련 규칙
CA1404: P/Invoke 다음에 바로 GetLastError를 호출하십시오.
CA1060: P/Invoke를 NativeMethods 클래스로 이동
CA1400: P/Invoke 진입점이 있어야 합니다.