CALLCONV Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Identifies the calling convention used by a method described in a METHODDATA structure.
public enum class CALLCONVpublic enum CALLCONV[System.Serializable]
public enum CALLCONVtype CALLCONV = [<System.Serializable>]
type CALLCONV = Public Enum CALLCONV- Inheritance
- Attributes
Fields
| Name | Value | Description |
|---|---|---|
| CC_CDECL | 1 | Indicates that the C declaration (CDECL) calling convention is used for a method. |
| CC_MSCPASCAL | 2 | Indicates that the MSC Pascal (MSCPASCAL) calling convention is used for a method. |
| CC_PASCAL | 2 | Indicates that the Pascal calling convention is used for a method. |
| CC_MACPASCAL | 3 | Indicates that the Macintosh Pascal (MACPASCAL) calling convention is used for a method. |
| CC_STDCALL | 4 | Indicates that the standard calling convention (STDCALL) is used for a method. |
| CC_RESERVED | 5 | This value is reserved for future use. |
| CC_SYSCALL | 6 | Indicates that the standard SYSCALL calling convention is used for a method. |
| CC_MPWCDECL | 7 | Indicates that the Macintosh Programmers' Workbench (MPW) CDECL calling convention is used for a method. |
| CC_MPWPASCAL | 8 | Indicates that the Macintosh Programmers' Workbench (MPW) PASCAL calling convention is used for a method. |
| CC_MAX | 9 | Indicates the end of the CALLCONV enumeration. |
Remarks
The calling conventions in this class describe how functions pass arguments and return values. They specify the order in which parameters are set up for the called functions, where the parameters are stored (in registers or in memory), and who (caller or called function) is responsible for cleaning up the stack after the function returns. For example:
CC_CDECL uses the naming and calling conventions of the C language. The caller pushes the parameters onto the stack in reverse (right-to-left) order, and cleans the stack after the function returns. This calling convention enables you to call functions with
varargs, which makes it appropriate for use with methods that accept a variable number of parameters, such as the C run-time functions printf, _printf_l, wprintf, _wprintf_l.CC_PASCAL uses the Pascal calling convention. The caller pushes the parameters onto the stack in left-to-right order. The called function cleans the stack before returning.
CC_STDCALL is the standard calling convention for Win32 functions. It is the default convention for calling unmanaged functions with platform invoke. The caller pushes the parameters onto the stack in reverse (right to left) order, and the called function cleans the stack before returning.
CC_SYSCALL is similar to CDECL in that arguments are pushed from right to left. The EAX, ECX, and EDX registers are not preserved.
These calling convention identifiers are used by the .NET Framework, the Windows Embedded CE platform, and by Automation.
The common language runtime throws an exception when a COM method in native code returns an HRESULT. For more information, see How to: Map HRESULTs and Exceptions.
