Функция 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 |