Método UCOMITypeInfo.Invoke (Object, Int32, Int16, DISPPARAMS, Object, EXCEPINFO, Int32)

Artigo
04/18/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.

Invoca um método ou acessa uma propriedade de um objeto que implementa a interface descrita pela descrição do tipo.

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

Sintaxe

void Invoke(
    object pvInstance,
    int memid,
    short wFlags,
    ref DISPPARAMS pDispParams,
    out object pVarResult,
    out EXCEPINFO pExcepInfo,
    out int puArgErr
)

void Invoke(
    Object^ pvInstance,
    int memid,
    short wFlags,
    DISPPARAMS% pDispParams,
    [OutAttribute] Object^% pVarResult,
    [OutAttribute] EXCEPINFO% pExcepInfo,
    [OutAttribute] int% puArgErr
)

abstract Invoke : 
        pvInstance:Object *
        memid:int *
        wFlags:int16 *
        pDispParams:DISPPARAMS byref *
        pVarResult:Object byref *
        pExcepInfo:EXCEPINFO byref *
        puArgErr:int byref -> unit

Sub Invoke (
    pvInstance As Object,
    memid As Integer,
    wFlags As Short,
    ByRef pDispParams As DISPPARAMS,
    <OutAttribute> ByRef pVarResult As Object,
    <OutAttribute> ByRef pExcepInfo As EXCEPINFO,
    <OutAttribute> ByRef puArgErr As Integer
)

Parâmetros

pvInstance
Type: System.Object

Referência à interface descrita por essa descrição de tipo.

memid
Type: System.Int32

Identifica o membro de interface.

wFlags
Type: System.Int16

Sinalizadores que descrevem o contexto da chamada invoke.

pDispParams
Type: System.Runtime.InteropServices.DISPPARAMS

Referência a uma estrutura que contém uma matriz de argumentos, uma matriz de DISPIDs para argumentos nomeados e a contagens do número de elementos em cada matriz.

pVarResult
Type: System.Object

Referência ao local em que o resultado será armazenado. Se wFlags especifica DISPATCH_PROPERTYPUT ou DISPATCH_PROPERTYPUTREF, pVarResult será ignorado. Definido como null se nenhum resultado for desejado.

pExcepInfo
Type: System.Runtime.InteropServices.EXCEPINFO

Aponta para uma estrutura de informações de exceção, que será preenchida somente se DISP_E_EXCEPTION for retornado.

puArgErr
Type: System.Int32

Se Invoke retorna DISP_E_TYPEMISMATCH, puArgErr indica o índice dentro rgvarg do argumento com um tipo incorreto. Se mais de um argumento retorna um erro, puArgErr indica o primeiro argumento com um erro.

Comentários

Os valores de pDispParams podem ser acessados por meio de PtrToStructure.

Os valores válidos para wFlags são:

Valor	Descrição
DISPATCH_METHOD	O membro é acessado como um método. Caso haja ambiguidade, este e DISPATCH_PROPERTYGET sinalizador pode ser definido.
DISPATCH_PROPERTYGET	O membro é recuperado como um propriedade ou membro de dados.
DISPATCH_PROPERTYPUT	O membro é alterado como um membro de dados ou de propriedade.
DISPATCH_PROPERTYPUTREF	O membro é alterado por meio de uma atribuição de referência, em vez de uma atribuição de valor. Esse valor é válido somente quando a propriedade aceita uma referência a um objeto.

Para obter informações adicionais sobre ITypeInfo::Invoke, consulte a biblioteca MSDN.

Informações de Versão

.NET Framework
Disponível desde 1.1

Confira Também

Interface UCOMITypeInfo
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via