C++ Builder 參考手冊 ? TComponent ? Invoke

頭文件：#include <System.Classes.hpp>
命名空間：System::Classes
類：TComponent
訪問權(quán)限：protected:
函數(shù)原型：

HRESULT __stdcall Invoke(
    int DispID, 
    const GUID &IID, 
    int LocaleID, 
    System::Word Flags, 
    void *pParams, 
    void *pVarResult, 
    void *pExcepInfo, 
    void *pArgErr);

System::Classes::TComponent::Invoke 是 System::Classes::TComponent 的成員函數(shù)捏卓，如果這個組件封裝了 COM 對象，Invoke 可以訪問 COM 對象的屬性和調(diào)用 COM 對象的方法梯啤。

參數(shù)：

• DispID：屬性、方法和參數(shù)的 ID赂毯，需要使用 GetIDsOfNames 方法獲群薇贰；
• IID：預(yù)留參數(shù)澡腾，必須是 IID_NULL敞映；
• LocaleID 區(qū)域和語言的 ID较曼，可以用 GetThreadLocale 獲取振愿；
• Flags：調(diào)用的類型：
  DISPATCH_METHOD：調(diào)用方法捷犹；
  DISPATCH_PROPERTYGET：讀屬性弛饭；
  DISPATCH_PROPERTYPUT：寫屬性；
  DISPATCH_PROPERTYPUTREF：寫屬性萍歉，通過傳引用而不是傳值侣颂；
• pParams：實際上是 DISPPARAMS * 類型的，調(diào)用函數(shù)的參數(shù)枪孩；
• pVarResult：實際上是 VARIANT * 類型的憔晒，函數(shù)的返回值，沒有返回值可以用 NULL蔑舞；
• pExcepInfo：實際上是 EXCEPINFO * 類型的拒担，如果 Invoke 返回值是 DISP_E_EXCEPTION，這個參數(shù)返回執(zhí)行異常攻询，不需要可以用 NULL从撼；
• pArgErr：實際上是 unsigned int * 類型的，如果參數(shù)有錯誤钧栖，Invoke
  的返回值是 DISP_E_TYPEMISMATCH 或 DISP_E_PARAMNOTFOUND低零，這個參數(shù)返回第一個出錯的參數(shù)的序號，如果不需要可以用 NULL拯杠。

返回值：

• 如果這個組件封裝了 COM 對象，Invoke 提供訪問 COM 對象的屬性和調(diào)用 COM 對象的方法揖膜。
• 如果組件封裝的是 IDispatch 接口誓沸，Invoke 會調(diào)用 IDispatch 的 Invoke 方法，并且把參數(shù)傳遞給 IDispatch 的 Invoke 方法壹粟；
• 參數(shù)所需的 DISPID 需要使用 GetIDsOfNames 方法獲取拜隧。

例：

LPCWSTR name = L"FuncName";
LCID lcid = GetThreadLocale();

DISPID dispid;
HRESULT hr = GetIDsOfNames(IID_NULL, (LPWSTR*)(&name), 1, lcid, &dispid);
System::Win::Comobj::OleCheck(hr);

WORD wFlags = DISPATCH_METHOD;

DISPPARAMS params;
::ZeroMemory(&params, sizeof(params));

VARIANT retVal;
::VariantInit(&retVal);

EXCEPINFO ExcepInfo;
::ZeroMemory(&ExcepInfo, sizeof(ExcepInfo));

UINT ErrArg = 0;

hr = Invoke(dispid, IID_NULL, lcid, wFlags, &params, &retVal, &ExcepInfo, &ErrArg);
if(hr == S_OK)

參考：

• System::Classes::TComponent::GetIDsOfNames
• System::Classes::TComponent::BeginInvoke
• System::Classes::TComponent::EndInvoke
• System::Classes::TComponent::EndFunctionInvoke
• System::Classes::TComponent::GetTypeInfo
• System::Classes::TComponent::GetTypeInfoCount
• System::Classes::TComponent
• System::Classes::TPersistent
• System::TObject
• PME 架構(gòu)
• VCL 類繼承關(guān)系

C++ Builder 參考手冊 ? TComponent ? Invoke