IExpDispSupport::OnInvoke 方法 (shdeprecated.h)

已弃用。 获取环境属性。

语法

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

参数

[in] dispidMember

类型: DISPID

标识正在调用的成员的调度 ID。

[in] iid

类型: REFIID

保留。 必须为 IID_NULL。

[in] lcid

类型: LCID

提供解释参数的区域设置上下文的区域设置 ID。 不支持多种语言的应用程序可以忽略此参数。

[in] wFlags

类型: WORD

描述调用上下文的标志,包括以下内容。

DISPATCH_METHOD

成员作为方法调用。 如果属性具有相同的名称,则可能同时设置此属性和DISPATCH_PROPERTYGET标志。 成员作为方法调用。 如果属性具有相同的名称,则可能同时设置此属性和DISPATCH_PROPERTYGET标志。

DISPATCH_PROPERTYGET

成员作为属性或数据成员进行检索。

DISPATCH_PROPERTYPUT

成员将更改为属性或数据成员。

DISPATCH_PROPERTYPUTREF

成员由引用赋值而不是值赋值更改。 仅当属性接受对 对象的引用时,此标志才有效。

pdispparams

类型: DISPPARAMS*

指向 DISPPARAMS 结构的指针,该结构包含参数数组、命名参数 DISPID 数组以及数组中元素数的计数。

pVarResult

类型: VARIANT*

指向存储结果的位置的指针;如果调用方不需要任何结果,则为 NULL 。 如果指定了DISPATCH_PROPERTYPUT或DISPATCH_PROPERTYPUTREF,则忽略此参数。

pexcepinfo

类型: EXCEPINFO*

指向一个包含异常信息的结构的指针。 如果返回DISP_E_EXCEPTION,则应填充此结构。 可以为 NULL

puArgErr

类型: UINT*

具有错误的第一个参数的 DISPPARAMS 结构的 rgvarg 成员内的索引。 参数按相反的顺序以 rgvarg 存储,因此第一个参数是数组中索引最高的参数。 仅当生成的返回值DISP_E_TYPEMISMATCH或DISP_E_PARAMNOTFOUND时,才会返回此参数。 此参数可以设置为 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

有关详细信息,请参阅 IDispatch::Invoke

要求

要求
目标平台 Windows
标头 shdeprecated.h