Método IExpDispSupport::OnInvoke (shdeprecated.h)

Preterido. Obtém propriedades de ambiente.

Sintaxe

HRESULT OnInvoke(
  [in] DISPID     dispidMember,
  [in] REFIID     iid,
  [in] LCID       lcid,
  [in] WORD       wFlags,
       DISPPARAMS *pdispparams,
       VARIANT    *pVarResult,
       EXCEPINFO  *pexcepinfo,
       UINT       *puArgErr
);

Parâmetros

[in] dispidMember

Tipo: DISPID

Uma ID de expedição que identifica o membro que está sendo invocado.

[in] iid

Tipo: REFIID

Reservado. Deve ser IID_NULL.

[in] lcid

Tipo: LCID

Uma ID de localidade que fornece um contexto de localidade no qual interpretar argumentos. Aplicativos que não dão suporte a vários idiomas podem ignorar esse parâmetro.

[in] wFlags

Tipo: WORD

Sinalizadores que descrevem o contexto da chamada, incluindo o seguinte.

DISPATCH_METHOD

O membro é invocado como um método . Se uma propriedade tiver o mesmo nome, esse e o sinalizador DISPATCH_PROPERTYGET poderão ser definidos. O membro é invocado como um método . Se uma propriedade tiver o mesmo nome, esse e o sinalizador DISPATCH_PROPERTYGET poderão ser definidos.

DISPATCH_PROPERTYGET

O membro é recuperado como uma propriedade ou membro de dados.

DISPATCH_PROPERTYPUT

O membro é alterado como uma propriedade ou membro de dados.

DISPATCH_PROPERTYPUTREF

O membro é alterado por uma atribuição de referência, em vez de uma atribuição de valor. Esse sinalizador é válido somente quando a propriedade aceita uma referência a um objeto .

pdispparams

Tipo: DISPPARAMS*

Um ponteiro para uma estrutura DISPPARAMS que contém uma matriz de argumentos, uma matriz de DISPIDs de argumento para argumentos nomeados e contagens para o número de elementos nas matrizes.

pVarResult

Tipo: VARIANT*

Um ponteiro para o local em que o resultado deve ser armazenado ou NULL se o chamador não espera nenhum resultado. Esse argumento será ignorado se DISPATCH_PROPERTYPUT ou DISPATCH_PROPERTYPUTREF for especificado.

pexcepinfo

Tipo: EXCEPINFO*

Um ponteiro para uma estrutura que contém informações de exceção. Essa estrutura deverá ser preenchida se DISP_E_EXCEPTION for retornado. Pode ser NULL.

puArgErr

Tipo: UINT*

O índice dentro do membro rgvarg da estrutura DISPPARAMS do primeiro argumento que tem um erro. Os argumentos são armazenados em rgvarg na ordem inversa, portanto, o primeiro argumento é aquele com o índice mais alto na matriz. Esse parâmetro é retornado somente quando o valor retornado resultante é DISP_E_TYPEMISMATCH ou DISP_E_PARAMNOTFOUND. Esse argumento pode ser definido como NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para obter mais informações, consulte IDispatch::Invoke.

Requisitos