CALLCONV CALLCONV CALLCONV CALLCONV Enum

Definition

Identifies the calling convention used by a method described in a METHODDATA structure.

public enum class CALLCONV
[System.Serializable]
public enum CALLCONV
type CALLCONV = 
Public Enum CALLCONV
Inheritance
Attributes

Fields

CC_CDECL CC_CDECL CC_CDECL CC_CDECL 1

Indicates that the C declaration (CDECL) calling convention is used for a method.

CC_MACPASCAL CC_MACPASCAL CC_MACPASCAL CC_MACPASCAL 3

Indicates that the Macintosh Pascal (MACPASCAL) calling convention is used for a method.

CC_MAX CC_MAX CC_MAX CC_MAX 9

Indicates the end of the CALLCONV enumeration.

CC_MPWCDECL CC_MPWCDECL CC_MPWCDECL CC_MPWCDECL 7

Indicates that the Macintosh Programmers' Workbench (MPW) CDECL calling convention is used for a method.

CC_MPWPASCAL CC_MPWPASCAL CC_MPWPASCAL CC_MPWPASCAL 8

Indicates that the Macintosh Programmers' Workbench (MPW) PASCAL calling convention is used for a method.

CC_MSCPASCAL CC_MSCPASCAL CC_MSCPASCAL CC_MSCPASCAL 2

Indicates that the MSC Pascal (MSCPASCAL) calling convention is used for a method.

CC_PASCAL CC_PASCAL CC_PASCAL CC_PASCAL 2

Indicates that the Pascal calling convention is used for a method.

CC_RESERVED CC_RESERVED CC_RESERVED CC_RESERVED 5

This value is reserved for future use.

CC_STDCALL CC_STDCALL CC_STDCALL CC_STDCALL 4

Indicates that the standard calling convention (STDCALL) is used for a method.

CC_SYSCALL CC_SYSCALL CC_SYSCALL CC_SYSCALL 6

Indicates that the standard SYSCALL calling convention is used for a method.

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.

Applies to

See also