Compartilhar via

Especificando um ponto de entrada

  • Artigo

Um ponto de entrada identifica o local de uma função em uma DLL. Em um projeto gerenciado, o nome original ou o ponto de entrada ordinal de uma função de destino identifica essa função no limite de interoperação. Além disso, é possível mapear o ponto de entrada para um nome diferente, renomeando a função efetivamente.

Veja a seguir uma lista dos possíveis motivos para renomear uma função de DLL:

  • Para evitar o uso de nomes de função de API que diferenciam maiúsculas de minúsculas

  • Para estar em conformidade com os padrões de nomenclatura existentes

  • Para acomodar funções que usam tipos de dados diferentes (declarando várias versões da mesma função de DLL)

  • Para simplificar o uso de APIs que contêm versões ANSI e Unicode

Este tópico demonstra como renomear uma função de DLL em um código gerenciado.

Renomeando uma função no Visual Basic

O Visual Basic usa a palavra-chave Function na instrução Declare para definir o campo DllImportAttribute.EntryPoint. O exemplo a seguir mostra uma declaração básica.

Friend Class NativeMethods
    Friend Declare Auto Function MessageBox Lib "user32.dll" (
        ByVal hWnd As IntPtr,
        ByVal lpText As String,
        ByVal lpCaption As String,
        ByVal uType As UInteger) As Integer
End Class

É possível substituir o ponto de entrada MessageBox por MsgBox incluindo a palavra-chave Alias na definição, conforme mostrado no exemplo a seguir. Nos dois exemplos, a palavra-chave Auto elimina a necessidade de especificar a versão do conjunto de caracteres do ponto de entrada. Para obter mais informações sobre como selecionar um conjunto de caracteres, consulte Especificando um conjunto de caracteres.

Friend Class NativeMethods
    Friend Declare Auto Function MsgBox _
        Lib "user32.dll" Alias "MessageBox" (
        ByVal hWnd As IntPtr,
        ByVal lpText As String,
        ByVal lpCaption As String,
        ByVal uType As UInteger) As Integer
End Class

Renomeando uma função no C# e C++

É possível usar o campo DllImportAttribute.EntryPoint para especificar uma função de DLL por nome ou ordinal. Se o nome da função na definição de método for o mesmo do ponto de entrada na DLL, você não precisará identificar explicitamente a função com o campo EntryPoint. Caso contrário, use um dos seguintes formatos de atributo para indicar um nome ou um ordinal:

[DllImport("DllName", EntryPoint = "Functionname")]
[DllImport("DllName", EntryPoint = "#123")]

Observe que é necessário prefixar um ordinal com o sinal de cerquilha (#).

O exemplo a seguir demonstra como substituir MessageBoxA por MsgBox no código usando o campo EntryPoint.

using System;
using System.Runtime.InteropServices;

internal static class NativeMethods
{
    [DllImport("user32.dll", EntryPoint = "MessageBoxA")]
    internal static extern int MsgBox(
        IntPtr hWnd, string lpText, string lpCaption, uint uType);
}

using namespace System;
using namespace System::Runtime::InteropServices;

typedef void* HWND;
[DllImport("user32", EntryPoint = "MessageBoxA")]
extern "C" int MsgBox(
    HWND hWnd, String* lpText, String* lpCaption, unsigned int uType);

Confira também