CALLCONV Enum

Definition

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

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

Fields

CC_CDECL 1

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

CC_MACPASCAL 3

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

CC_MAX 9

Indicates the end of the CALLCONV enumeration.

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_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_RESERVED 5

This value is reserved for future use.

CC_STDCALL 4

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

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