Метод IBindCtx::GetRunningObjectTable (objidl.h)
Извлекает указатель интерфейса на таблицу выполняющихся объектов (ROT) для компьютера, на котором выполняется этот контекст привязки.
Синтаксис
HRESULT GetRunningObjectTable(
[out] IRunningObjectTable **pprot
);
Параметры
[out] pprot
Адрес переменной указателя IRunningObjectTable*, которая получает указатель интерфейса на таблицу выполняющихся объектов. При возникновении ошибки параметру *pprot присваивается значение NULL. Если *pprot имеет значение, отличное от NULL, реализация вызывает AddRef для выполняющегося объекта таблицы; вызов Release лежит на вызывающем объекте.
Возвращаемое значение
Этот метод может возвращать стандартные возвращаемые значения E_OUTOFMEMORY, E_UNEXPECTED и S_OK.
Комментарии
Запущенная таблица объектов является глобально доступной таблицей на каждом компьютере. Он отслеживает все объекты, которые в данный момент выполняются на компьютере.
Примечания к вызывающим абонентам
Как правило, те, кто реализует новый класс моникера (через реализацию интерфейса IMoniker ), вызывают Метод GetRunningObjectTable. Этот метод полезно вызывать в реализации IMoniker::BindToObject или IMoniker::IsRunning, чтобы проверка, выполняется ли объект в данный момент. Этот метод также можно вызвать в реализации IMoniker::GetTimeOfLastChange , чтобы узнать, когда выполняющийся объект был изменен в последний раз.Реализации моникера должны вызывать этот метод вместо использования функции GetRunningObjectTable . Это позволяет будущим реализациям IBindCtx изменять поведение привязки.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | objidl.h |