ComWrappers.GetOrRegisterObjectForComInstance Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Sobrecargas

GetOrRegisterObjectForComInstance(IntPtr, CreateObjectFlags, Object)	Obtém o objeto gerenciado registrado no momento ou usa o objeto gerenciado fornecido e o registra.
GetOrRegisterObjectForComInstance(IntPtr, CreateObjectFlags, Object, IntPtr)	Obtenha o objeto gerenciado registrado no momento ou usa o objeto gerenciado fornecido e o registra.

GetOrRegisterObjectForComInstance(IntPtr, CreateObjectFlags, Object)

Origem:

ComWrappers.cs

Obtém o objeto gerenciado registrado no momento ou usa o objeto gerenciado fornecido e o registra.

public:
 System::Object ^ GetOrRegisterObjectForComInstance(IntPtr externalComObject, System::Runtime::InteropServices::CreateObjectFlags flags, System::Object ^ wrapper);

public object GetOrRegisterObjectForComInstance (IntPtr externalComObject, System.Runtime.InteropServices.CreateObjectFlags flags, object wrapper);

member this.GetOrRegisterObjectForComInstance : nativeint * System.Runtime.InteropServices.CreateObjectFlags * obj -> obj

Public Function GetOrRegisterObjectForComInstance (externalComObject As IntPtr, flags As CreateObjectFlags, wrapper As Object) As Object

Parâmetros

externalComObject

IntPtr

nativeint

Objeto a ser importado para uso no runtime do .NET.

flags

CreateObjectFlags

Sinalizadores usados para descrever o objeto externo.

wrapper

Object

O objeto a ser usado como wrapper para o objeto externo.

Retornos

Object

Um objeto gerenciado associado ao objeto COM externo fornecido.

Exceções

NotSupportedException

A instância de wrapper já está associada a um objeto externo.

Comentários

Se a wrapper instância já tiver um objeto externo associado, um NotSupportedException será gerado.

GetOrRegisterObjectForComInstance(IntPtr, CreateObjectFlags, Object, IntPtr)

Origem:

ComWrappers.cs

Obtenha o objeto gerenciado registrado no momento ou usa o objeto gerenciado fornecido e o registra.

public:
 System::Object ^ GetOrRegisterObjectForComInstance(IntPtr externalComObject, System::Runtime::InteropServices::CreateObjectFlags flags, System::Object ^ wrapper, IntPtr inner);

public object GetOrRegisterObjectForComInstance (IntPtr externalComObject, System.Runtime.InteropServices.CreateObjectFlags flags, object wrapper, IntPtr inner);

member this.GetOrRegisterObjectForComInstance : nativeint * System.Runtime.InteropServices.CreateObjectFlags * obj * nativeint -> obj

Public Function GetOrRegisterObjectForComInstance (externalComObject As IntPtr, flags As CreateObjectFlags, wrapper As Object, inner As IntPtr) As Object

Parâmetros

externalComObject

IntPtr

nativeint

Objeto a ser importado para uso no runtime do .NET.

flags

CreateObjectFlags

Sinalizadores usados para descrever o objeto externo.

wrapper

Object

O Object a ser usado como o wrapper para o objeto externo

inner

IntPtr

nativeint

Interno para cenários de agregação COM

Retornos

Object

Retorna um objeto gerenciado associado ao objeto COM externo fornecido.

Comentários

Essa substituição de método é para registrar uma instância COM agregada com seu interior associado. O interior será liberado quando o wrapper associado for finalmente liberado. Observe que ele será lançado em um thread em um estado de apartamento desconhecido. Se o interno fornecido não for conhecido por ser uma instância de thread livre, é recomendável não fornecer o interno.

Se a wrapper instância já tiver um objeto externo associado, um NotSupportedException será gerado.