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


Метод 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

См. также раздел

IBindCtx

IMoniker

IRunningObjectTable