Функция GetRunningObjectTable (objbase.h)

Возвращает указатель на интерфейс IRunningObjectTable в локальной таблице выполняющихся объектов (ROT).

Синтаксис

HRESULT GetRunningObjectTable(
  [in]  DWORD                reserved,
  [out] LPRUNNINGOBJECTTABLE *pprot
);

Параметры

[in] reserved

Этот параметр зарезервирован и должен иметь значение 0.

[out] pprot

Адрес переменной указателя IRunningObjectTable*, которая получает указатель интерфейса на локальный объект ROT. При успешном выполнении функции вызывающий объект отвечает за вызов Release в указателе интерфейса. При возникновении ошибки значение *pprot не определено.

Возвращаемое значение

Эта функция может возвращать стандартные возвращаемые значения E_UNEXPECTED и S_OK.

Комментарии

Каждая рабочая станция имеет локальный rot, который поддерживает таблицу объектов, которые были зарегистрированы как запущенные на этом компьютере. Эта функция возвращает указатель интерфейса IRunningObjectTable , который предоставляет доступ к этой таблице.

Поставщики моникеров, которые раздают моникеры, определяющие объекты, чтобы они были доступны другим пользователям, должны вызывать Метод GetRunningObjectTable. Используйте указатель интерфейса, возвращенный этой функцией, для регистрации объектов при их запуске, записи времени изменения этих объектов и отмены их регистрации при остановке выполнения. Дополнительные сведения см. в интерфейсе IRunningObjectTable .

Источники ссылок на составные документы являются наиболее распространенным примером поставщиков моникеров. К ним относятся серверные приложения, поддерживающие связывание со своими документами (или частями документа), и контейнерные приложения, поддерживающие связывание с внедренными в них документами. Серверные приложения, которые не поддерживают связывание, также могут использовать ROT для взаимодействия с контейнерными приложениями, поддерживающими связывание с внедрением.

Если вы реализуете интерфейс IMoniker для написания нового класса моникера и вам нужен указатель интерфейса на ROT, вызовите IBindCtx::GetRunningObjectTable , а не функцию GetRunningObjectTable . Это позволяет будущим реализациям интерфейса IBindCtx изменять поведение привязки.

Требования

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

IBindCtx::GetRunningObjectTable

IMoniker

IRunningObjectTable