Método Marshal.GetTypedObjectForIUnknown (IntPtr, Type)

Artigo
04/16/2018

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Retorna um objeto gerenciado de um tipo especificado que representa um objeto COM.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

[SecurityCriticalAttribute]
public static object GetTypedObjectForIUnknown(
    IntPtr pUnk,
    Type t
)

public:
[SecurityCriticalAttribute]
static Object^ GetTypedObjectForIUnknown(
    IntPtr pUnk,
    Type^ t
)

[<SecurityCriticalAttribute>]
static member GetTypedObjectForIUnknown : 
        pUnk:nativeint *
        t:Type -> Object

<SecurityCriticalAttribute>
Public Shared Function GetTypedObjectForIUnknown (
    pUnk As IntPtr,
    t As Type
) As Object

Parâmetros

pUnk
Type: System.IntPtr

Um ponteiro para a interface IUnknown do objeto não gerenciado.

t
Type: System.Type

O tipo da classe gerenciada solicitada.

Valor Retornado

Type: System.Object

Uma instância da classe correspondente ao objeto Type que representa o objeto COM não gerenciado solicitado.

Exceções

Exception	Condition
ArgumentException	t não está atribuído com System.Runtime.InteropServices.ComImportAttribute. -ou- t é um tipo Tempo de Execução do Windows.

Comentários

O t parâmetro deve ser um tipo importado COM ou um subtipo de um tipo importado COM. Além disso, t deve ser um tipo cujos metadados foi importado de Tlbimp.exe (Importador de Biblioteca de Tipos) ferramenta. Esse tipo deve ser uma classe e não uma interface coclass associado, que assume o nome da classe COM. Por exemplo, se importa Tlbimp.exe Myclass como uma classe chamada MyclassClass e como uma interface coclass chamado Myclass, você deve usar MyclassClass (não Myclass) com esse método. Para obter informações adicionais sobre importados classes e interfaces de coclass, consulte conversão de tipo importado.

Se um objeto já foi obtido para o pUnk parâmetro t é ignorado e o objeto existente será retornado.pUnkrepresenta umIUnknown ponteiro de interface; no entanto, já que todas as interfaces COM derivam diretamente ou indiretamente de IUnknown, você pode passar qualquer interface COM para esse método. O objeto retornado por GetTypedObjectForIUnknown é um RCW (Runtime Callable Wrapper) (RCW), que gerencia o common language runtime como ele faz qualquer outro objeto gerenciado.

Segurança

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Informações de Versão

.NET Framework
Disponível desde 1.1

Confira Também

ComImportAttribute
Classe Marshal
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via