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

Статья
08/25/2023

Возвращает указатель на интерфейс 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 изменять поведение привязки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	objbase.h
Библиотека	Ole32.lib
DLL	Ole32.dll
Набор API	ext-ms-win-com-ole32-l1-1-0 (появилось в Windows 8)

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

IBindCtx::GetRunningObjectTable

IMoniker

IRunningObjectTable

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