CoIsHandlerConnected 函数 (combaseapi.h)

  • 项目

确定远程对象是否连接到相应的进程内对象。

语法

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

参数

[in] pUnk

指向远程对象上控制 IUnknown 接口的指针。

返回值

如果对象不是远程对象，或者它是远程对象且仍处于连接状态，则返回值为 TRUE;否则为 FALSE。

注解

CoIsHandlerConnected 函数确定远程对象的状态。 可以使用它来确定何时释放远程对象。 可以通过为函数提供指向其控制 IUnknown 接口的指针来指定远程对象， (pUnk 参数) 。 从 函数返回的 TRUE 值指示指定的对象不是远程对象，或者它是远程对象，并且仍连接到其远程处理程序。 从 函数返回的 FALSE 值指示对象是远程对象，但不再连接到其远程处理程序;在这种情况下，调用方应通过释放 对象来响应。

要求

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