Deben existir los puntos de entrada P/Invoke

Actualización: noviembre 2007

Motivo

Un método público o protegido se marca con System.Runtime.InteropServices.DllImportAttribute. No se pudo encontrar la biblioteca no administrada o el método no coincide con una función de la biblioteca. Si la regla no encuentra el nombre del método exactamente como se especifica, busca caracteres ANSI o versiones de caracteres extendidos del método añadiéndole al nombre del método un sufijo 'A' o 'W'. Si no lo encuentra, la regla intenta buscar una función utilizando el formato de nombre __stdcall (_MyMethod@12, donde 12 representa la longitud de los argumentos). Si no lo encuentra, y el nombre del método empieza por '#', la regla busca la función como una referencia ordinal en lugar de una referencia de nombre.

Descripción de la regla

No hay ninguna comprobación en tiempo de compilación para garantizar que hay métodos marcados con DllImportAttribute en el archivo DLL no administrado al que se hace referencia. Si en la biblioteca no hay ningún método con el nombre especificado, o los argumentos al método no coinciden con los argumentos de la función, el common language runtime produce una excepción.

Cómo corregir infracciones

Para corregir una infracción de esta regla, corrija el método que tiene el atributo DllImportAttribute. Asegúrese de que la biblioteca no administrada existe y está en el mismo directorio que el ensamblado que contiene el método. Si la biblioteca está presente y se hace referencia a la misma correctamente, compruebe que el nombre de método, el tipo de valor devuelto y la firma del argumento coinciden con la función de biblioteca.

Cuándo suprimir advertencias

No suprima ninguna advertencia de esta regla cuando la biblioteca no administrada esté en el mismo directorio que el ensamblado administrado que hace referencia a ella. Podría ser seguro suprimir una advertencia de esta regla si no se pudo encontrar la biblioteca no administrada.

Ejemplo

El siguiente ejemplo muestra un tipo que infringe la regla. No hay ninguna función denominada DoSomethingUnmanaged en kernel32.dll

using System.Runtime.InteropServices;

namespace InteroperabilityLibrary
{
   public class NativeMethods
   {
      // If DoSomethingUnmanaged does not exist, or has 
      // a different signature or return type, the following 
      // code violates rule PInvokeEntryPointsShouldExist.
      [DllImport("kernel32.dll")]
      public static extern void DoSomethingUnmanaged();
   }
}

Vea también

Referencia

System.Runtime.InteropServices.DllImportAttribute