CorPinvokeMap Enumeration
Specifies options for a PInvoke call.
typedef enum CorPinvokeMap {
pmNoMangle = 0x0001,
pmCharSetMask = 0x0006,
pmCharSetNotSpec = 0x0000,
pmCharSetAnsi = 0x0002,
pmCharSetUnicode = 0x0004,
pmCharSetAuto = 0x0006,
pmBestFitUseAssem = 0x0000,
pmBestFitEnabled = 0x0010,
pmBestFitDisabled = 0x0020,
pmBestFitMask = 0x0030,
pmThrowOnUnmappableCharUseAssem = 0x0000,
pmThrowOnUnmappableCharEnabled = 0x1000,
pmThrowOnUnmappableCharDisabled = 0x2000,
pmThrowOnUnmappableCharMask = 0x3000,
pmSupportsLastError = 0x0040,
pmCallConvMask = 0x0700,
pmCallConvWinapi = 0x0100,
pmCallConvCdecl = 0x0200,
pmCallConvStdcall = 0x0300,
pmCallConvThiscall = 0x0400,
pmCallConvFastcall = 0x0500,
pmMaxValue = 0xFFFF
} CorPinvokeMap;
Members
Member |
Description |
|---|---|
pmNoMangle |
Use each member name as specified. |
pmCharSetMask |
Reserved. |
pmCharSetNotSpec |
Reserved. |
pmCharSetAnsi |
Marshal strings as multiple-byte character strings. |
pmCharSetUnicode |
Marshal strings as Unicode 2-byte characters. |
pmCharSetAuto |
Automatically marshal strings appropriately for the target operating system. The default is Unicode on Windows NT, Windows 2000, Windows XP, and the Windows Server 2003 family; the default is ANSI on Windows 98 and Windows Me. |
pmBestFitUseAssem |
Reserved. |
pmBestFitEnabled |
Perform best-fit mapping of Unicode characters that lack an exact match in the ANSI character set. |
pmBestFitDisabled |
Do not perform best-fit mapping of Unicode characters. In this case, all unmappable characters will be replaced by a ‘?’. |
pmBestFitMask |
Reserved. |
pmThrowOnUnmappableCharUseAssem |
Reserved. |
pmThrowOnUnmappableCharEnabled |
Throw an exception when the interop marshaler encounters an unmappable character. |
pmThrowOnUnmappableCharDisabled |
Do not throw an exception when the interop marshaler encounters an unmappable character. |
pmThrowOnUnmappableCharMask |
Reserved |
pmSupportsLastError |
Allow the callee to call the Win32 SetLastError function before returning from the attributed method. |
pmCallConvMask |
Reserved |
pmCallConvWinapi |
Use the default platform calling convention. For example, on Windows the default is StdCall and on Windows CE .NET it is Cdecl. |
pmCallConvCdecl |
Use the Cdecl calling convention. In this case, the caller cleans the stack. This enables calling functions with varargs (that is, functions that accept a variable number of parameters). |
pmCallConvStdcall |
Use the StdCall calling convention. In this case, the callee cleans the stack. This is the default convention for calling unmanaged functions with platform invoke. |
pmCallConvThiscall |
Use the ThisCall calling convention. In this case, the first parameter is the this pointer and is stored in register ECX. Other parameters are pushed on the stack. The ThisCall calling convention is used to call methods on classes exported from an unmanaged DLL. |
pmCallConvFastcall |
Reserved. |
pmMaxValue |
Reserved. |
Requirements
Platforms: Windows 2000, Windows XP, Windows Server 2003 family
Header: CorHdr.h
.NET Framework Version: 2.0, 1.1, 1.0