IExternalConnection：：ReleaseConnection 方法 (objidlbase.h)

  • 项目

递减对象的强外部连接的计数。

语法

DWORD ReleaseConnection(
  [in] DWORD extconn,
  [in] DWORD reserved,
  [in] BOOL  fLastReleaseCloses
);

参数

[in] extconn

与 对象的外部连接的类型。 此接口当前支持的唯一外部连接类型是强连接，这意味着只要此外部连接存在，对象必须保持活动状态。 强外部连接由枚举 EXTCONN 中定义的值 EXTCONN_STRONG 表示。

[in] reserved

有关连接的信息。 此参数保留供 OLE 使用。 其值可以为零，但不一定。 因此， ReleaseConnection 的实现不应包含其执行取决于是否返回零值的代码块。

[in] fLastReleaseCloses

如果释放的连接是对象上的最后一个外部锁，则此参数为 TRUE ，因此对象应关闭。 否则，对象应保持打开状态，直到被用户或其他进程关闭。

返回值

方法返回连接计数。 此值仅用于调试目的。

注解

如果 fLastReleaseCloses 等于 TRUE，则调用 ReleaseConnection 会导致对象自行关闭。 调用此方法是在与容器应用程序相同的进程空间中运行的 DLL 对象知道在无提示更新后何时关闭的唯一方法。

要求

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

另请参阅

IExternalConnection