Метод IRunningObjectTable::Revoke (objidl.h)
Удаляет запись из таблицы выполняющихся объектов (ROT), которая была ранее зарегистрирована вызовом метода IRunningObjectTable::Register.
Синтаксис
HRESULT Revoke(
[in] DWORD dwRegister
);
Параметры
[in] dwRegister
Идентификатор отозванной записи ROT.
Возвращаемое значение
Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG и S_OK.
Комментарии
Этот метод отменяет эффект вызова метода IRunningObjectTable::Register, удаляя моникер и указатель на объект, определяемый этим моникером.
Примечания к вызывающим абонентам
Поставщик моникеров (раздает моникеры, идентифицирующие его объекты, чтобы сделать их доступными для других пользователей) должен вызвать метод Revoke , чтобы отменить регистрацию своих объектов при остановке выполнения. Он должен ранее вызвать IRunningObjectTable::Register и сохранить идентификатор, возвращенный этим методом; он использует этот идентификатор при вызове Revoke.Наиболее распространенным типом поставщика моникеров является составной источник ссылки на документ. К ним относятся серверные приложения, поддерживающие связывание со своими документами (или их частями), и приложения-контейнеры, поддерживающие связывание с внедрением в своих документах. Серверные приложения, которые не поддерживают связывание, также могут использовать ROT для взаимодействия с контейнерными приложениями, поддерживающими связывание с внедрением.
При написании приложения-контейнера необходимо отозвать регистрацию документа при закрытии документа. Кроме того, перед повторной регистрацией документа при переименовании необходимо отозвать регистрацию документа.
При написании серверного приложения необходимо отозвать регистрацию объекта при закрытии объекта. Необходимо также отменить регистрацию объекта перед повторной регистрацией при переименовании документа контейнера (см . раздел IOleObject::SetMoniker).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | objidl.h |