Поделиться через


Функция 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
Header combaseapi.h (включая Objbase.h)
Библиотека Ole32.lib
DLL Ole32.dll