Основы описания

Field

Description

BestFitMapping

Enables or disables best-fit mapping.

CallingConvention

Specifies the calling convention to use in passing method arguments. The default is WinAPI, which corresponds to __stdcall for the 32-bit Intel-based platforms.

CharSet

Controls name mangling and the way that string arguments should be marshaled to the function. The default is CharSet.Ansi.

EntryPoint

Specifies the DLL entry point to be called.

ExactSpelling

Controls whether an entry point should be modified to correspond to the character set. The default value varies by programming language.

PreserveSig

Controls whether the managed method signature should be transformed into an unmanaged signature that returns an HRESULT and has an additional [out, retval] argument for the return value.

The default is true (the signature should not be transformed).

SetLastError

Enables the caller to use the Marshal.GetLastWin32Error API function to determine whether an error occurred while executing the method. In Visual Basic, the default is true; in C# and C++, the default is false.

ThrowOnUnmappableChar

Controls throwing of an exception on an unmappable Unicode character that is converted to an ANSI "?" character.

Поле

Описание

BestFitMapping

Включает и отключает наилучшее сопоставление.

CallingConvention

Задает соглашение о вызовах, которое должно использоваться при передаче аргументов методов. По умолчанию используется значение WinAPI, соответствующее режиму __stdcall для 32-разрядных платформ на основе процессора Intel.

CharSet

Управляет изменением имен при передаче и задает способ маршалинга строковых аргументов в функцию. По умолчанию используется CharSet.Ansi.

EntryPoint

Задает точку входа DLL для вызова.

ExactSpelling

Определяет, должна ли изменяться точка входа в соответствии с кодировкой. Значение зависит от языка программирования.

PreserveSig

Определяет, должна ли управляемая подпись метода преобразоваться в неуправляемую подпись, которая возвращает значение HRESULT и для возвращаемого значения имеет дополнительный аргумент [out, retval].

По умолчанию используется значение true (подпись не должна преобразовываться).

SetLastError

Позволяет вызывающему объекту при выполнении метода для определения факта ошибки использовать функцию интерфейса API Marshal.GetLastWin32Error. В Visual Basic по умолчанию используется значение true, в C# и C++ — значение false.

ThrowOnUnmappableChar

Управляет возникновением исключения при появлении несопоставимого символа Юникода, который преобразуется в символ ANSI "?".

[DllImport("dllname", EntryPoint="Functionname")]

[DllImport("dllname", EntryPoint="#123")]

using System.Runtime.InteropServices;

public class Win32 {

[DllImport("user32.dll", EntryPoint="MessageBoxA")]

public static extern int MsgBox(int hWnd, String text, String caption, uint type);

}