imported>InternetArchiveBot：补救4个来源，并将0个来源标记为失效。) #IABot (v2.0.7

2020-12-09T00:07:05Z

补救4个来源，并将0个来源标记为失效。) #IABot (v2.0.7

新页面

{{noteTA
|G1=IT
|G2=Windows
|2=zh-hans:组件对象模型; zh-hant:元件物件模型;
|3=zh-hans:对象链接与嵌入;zh-hant:物件連結與嵌入;
|4=zh-hans:对象; zh-hant:物件;
|5=zh-hans:组件; zh-hant:元件;
|6=zh-hans:链接; zh-hant:連結;
|7=zh-hans:程序; zh-hant:程式;
|8=zh-hans:自省; zh-hant:內觀資訊;
}}
'''IDispatch'''[[介面 (資訊科技)|介面]]是[[组件对象模型]]（COM）中的标准介面，也称'''自动化'''（Automation）接口，继承自[[IUnknown]]，用于讓其他函式使用{{tsl|en|OLE Automation|OLE Automation}}协议<ref>Microsoft MSDN: [http://msdn.microsoft.com/en-us/library/ms221608.aspx IDispatch interface] {{Wayback|url=http://msdn.microsoft.com/en-us/library/ms221608.aspx |date=20180223051201 }}</ref>。COM規格書<ref>{{Cite web |url=http://www.microsoft.com/com/resources/comdocs.asp |title=COM specification |access-date=2016-12-26 |archive-url=https://web.archive.org/web/20161221063614/http://www.microsoft.com/Com/resources/comdocs.asp |archive-date=2016-12-21 |dead-url=yes }}</ref>規定COM物件应该是三种接口类型中的至少一种：
*基于虚表（vtable）的[[IUnknown]]的定制接口；
*分派（dispatch）的IDispatch接口以支持內觀資訊（introspection）。允许客户应用程序在[[运行时]]查出COM组件支持哪些属性与方法，即实现了[[运行期类型信息]]（RTTI）。客户应用程序[[编译时]]不需要知道COM的对象成员。脚本语言如[[VBS]]不能使用指针乃至[[函数指针]]，只能通过IDispatch接口访问COM组件。这是通过执行IDispatch接口中的Invoke方法。这是一种{{tsl|en|Late binding|迟绑定}}。与第一种定制接口相比，增加了內觀資訊与invoke的开销。<ref>Microsoft MSDN: [http://www.microsoft.com/msj/1295/activex1295.aspx ActiveX/COM Q&A December 1995] {{Wayback|url=http://www.microsoft.com/msj/1295/activex1295.aspx |date=20160306062514 }}</ref>
*dual接口，同时支持上述两种类型的接口
==方法==
支持IDispatch的COM对象实现的每个属性与方法都有自己的Dispatch ID，常缩写为DISPID。用于在''Invoke''方法中辨识哪个属性或方法将被调用。

IDispatch派生自[[IUnknown]]，并且扩展了4个额外的方法：
<syntaxhighlight lang="cpp">
interface IDispatch : public IUnknown {
virtual HRESULT GetTypeInfoCount(unsigned int * pctinfo) = 0;
virtual HRESULT GetTypeInfo(unsigned int iTInfo,
LCID lcid,
ITypeInfo ** ppTInfo
) = 0;
virtual HRESULT GetIDsOfNames(REFIID riid,
OLECHAR ** rgszNames,
unsigned int cNames,
LCID lcid,
DISPID * rgDispId
) = 0;
virtual HRESULT Invoke(DISPID dispIdMember,
REFIID riid,
LCID lcid,
WORD wFlags,
DISPPARAMS * pDispParams,
VARIANT * pVarResult,
EXCEPINFO * pExcepInfo,
unsigned int * puArgErr
) = 0;
};
</syntaxhighlight>
'''IDispatch'''的[[接口标识符]]被定义为[[GUID]]值{00020400-0000-0000-C000-000000000046}。
==參考資料==
{{reflist}}

==相關條目==
*[[IFilter]]
*[[IInspectable]]
*[[IObjectWithSite]]
*[[IOleObject]]

==外部連結==
* [http://www.codeproject.com/kb/com/com_in_c1.aspx COM in plain C]{{Wayback|url=http://www.codeproject.com/kb/com/com_in_c1.aspx |date=20151105010714 }}

[[Category:面向对象的程序设计]]
[[Category:微軟API]]

IDispatch - 版本历史

imported>InternetArchiveBot：​补救4个来源，并将0个来源标记为失效。) #IABot (v2.0.7

imported>InternetArchiveBot：补救4个来源，并将0个来源标记为失效。) #IABot (v2.0.7