UnmanagedCallConvAttribute Classe

Definição

Espaço de Nomes:

System.Runtime.InteropServices

Assemblagem:

System.Runtime.InteropServices.dll

Origem:

UnmanagedCallConvAttribute.cs

Especifica a convenção de chamada necessária para chamar métodos P/Invoke implementados em código não gerido.

public ref class UnmanagedCallConvAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
public sealed class UnmanagedCallConvAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
type UnmanagedCallConvAttribute = class
    inherit Attribute

Public NotInheritable Class UnmanagedCallConvAttribute
Inherits Attribute

Herança

Object

Attribute

UnmanagedCallConvAttribute

Atributos

AttributeUsageAttribute

Exemplos

Os exemplos seguintes declaram P/Invokes usando a UnmanagedCallConvAttribute para especificar a convenção de chamada.

Usando a cdecl convenção de chamada:

// Target will be invoked using the cdecl calling convention
[UnmanagedCallConv(CallConvs = new Type[] { typeof(CallConvCdecl) })]
[DllImport("NativeLibrary", EntryPoint = "native_function_cdecl")]
internal static extern int NativeFunction(int arg);

// Target will be invoked using the cdecl calling convention and with the GC transition suppressed
[UnmanagedCallConv(CallConvs = new Type[] { typeof(CallConvCdecl), typeof(CallConvSuppressGCTransition) })]
[DllImport("NativeLibrary", EntryPoint = "native_function_cdecl")]
internal static extern int NativeFunction_NoGCTransition(int arg);

Usando a stdcall convenção de chamada:

// Target will be invoked using the stdcall calling convention
[UnmanagedCallConv(CallConvs = new Type[] { typeof(CallConvStdcall) })]
[DllImport("NativeLibrary", EntryPoint = "native_function_stdcall")]
internal static extern int NativeFunction(int arg);

// Target will be invoked using the stdcall calling convention and with the GC transition suppressed
[UnmanagedCallConv(CallConvs = new Type[] { typeof(CallConvStdcall), typeof(CallConvSuppressGCTransition) })]
[DllImport("NativeLibrary", EntryPoint = "native_function_stdcall")]
internal static extern int NativeFunction_NoGCTransition(int arg);

Observações

Quando este atributo é aplicado a um método com DllImportAttribute onde CallingConvention não está definido ou definido para Winapi, o runtime de .NET usará CallConvs para determinar a convenção de chamada do P/Invoke.

Este atributo é ignorado se aplicado a um método sem DllImportAttribute ou com CallingConvention definido a algo diferente de Winapi.

Construtores

Name	Description
UnmanagedCallConvAttribute()	Inicializa uma nova UnmanagedCallConvAttribute instância.

Campos

Name	Description
CallConvs	Optional. Tipos que indicam convenções de chamada para o alvo não gerido.

Propriedades

Name	Description
TypeId	Quando implementado numa classe derivada, obtém um identificador único para esta Attribute. (Herdado de Attribute)

Métodos

Name	Description
Equals(Object)	Devolve um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Devolve o código de hash para esta instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)