IOleLink：：BindToSource 方法 (oleidl.h)

项目
03/04/2024

通过绑定链接对象中存储的名称对象来激活与链接源的连接。

语法

HRESULT BindToSource(
  [in] DWORD    bindflags,
  [in] IBindCtx *pbc
);

参数

[in] bindflags

指定如果链接源具有与上次绑定时不同的 CLSID，则如何继续操作。如果此参数为零且 CLSID 不同，则方法将失败并返回OLE_E_CLASSDIFF。如果指定了 OLELINKBIND 枚举中的OLELINKBIND_EVENIFCLASSDIFF值，并且 CLSID 不同，则方法将成功绑定并更新存储在链接对象中的 CLSID。

[in] pbc

指向要在此绑定操作中使用的绑定上下文上的 IBindCtx 接口的指针。此参数可以为 NULL。绑定上下文缓存绑定过程中绑定的对象，包含应用于使用绑定上下文的所有操作的参数，并提供绑定实现应检索有关其环境的信息的方法。有关详细信息，请参阅 IBindCtx。

返回值

此方法在成功时返回S_OK。其他可能的返回值包括以下内容。

返回代码	说明
OLE_E_CLASSDIFF	链接源未绑定，因为它的 CLSID 已更改。仅当 bindflags 参数中未指定 OLELINKBIND_EVENIFCLASSDIFF 标志时，才会返回此错误。
MK_E_NOOBJECT	如果链接源的名字对象是复合) 找不到在复合中标识的某些中间对象，则找不到链接源或 (。
E_UNSPEC	链接的名称为 NULL。

绑定名字对象可能需要调用 CreateBindCtx 函数;因此，此方法可能会返回 CreateBindCtx 生成的错误。

注解

给调用方的说明

通常，容器应用程序不需要直接调用 IOleLink：：BindToSource 方法。当需要激活与链接源的连接时，容器通常会调用 IOleObject：:D oVerb、 IOleObject：：Update 或 IOleLink：：Update。链接对象的这些方法的实现调用 IOleLink：：BindToSource。容器还可以调用 OleRun 函数，该函数在对链接对象调用 时调用 IOleLink：：BindToSource 。

在前面列出的每个间接调用 IOleLink：：BindToSource 的示例中，bindflags 参数设置为零。因此，如果链接源的类不同于上次绑定链接对象的类，这些调用可能会失败并出现OLE_E_CLASSDIFF错误。例如，如果原始链接源是最终用户随后使用“更改类型”对话框) Excel 电子表格 (嵌入的 Lotus 电子表格，则可能会出现这种情况。

如果希望容器绑定，即使链接源现在具有不同的 CLSID，也可以直接调用 IOleLink：：BindToSource 并为 bindflags 参数指定OLELINKBIND_EVENIFCLASSDIFF。此调用绑定到链接源并更新链接对象的 CLSID。或者，容器可以删除现有链接，并使用 OleCreateLink 函数创建新的链接对象。

实施者说明

链接对象缓存指向绑定期间获取的链接源的接口指针。

链接对象的 IOleLink：：BindToSource 实现首先尝试使用由复合文档的名字对象组成的名字对象进行绑定，该名字对象由链接源的相对名字对象组成。如果成功，它将更新链接的绝对名字对象。否则，它会尝试使用绝对名字对象进行绑定，如果成功，则更新相对名字对象。

如果 IOleLink：：BindToSource 绑定到链接源，它将调用复合文档的 IOleContainer：：LockContainer 实现，以在链接源运行时使包含的复合文档保持活动状态。 IOleLink：：BindToSource 还调用链接源的 IOleObject：：Advise 和 IDataObject：:D Advise 实现来设置咨询连接。 IOleLink：：UnbindSource 实现可解锁容器并删除咨询连接。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	oleidl.h