共用方式為


IRunningObjectTable::Revoke 方法 (objidl.h)

從執行中的對象數據表中移除專案, (ROT) 先前由 IRunningObjectTable::Register 呼叫所註冊

語法

HRESULT Revoke(
  [in] DWORD dwRegister
);

參數

[in] dwRegister

要撤銷之 ROT 項目的識別碼。

傳回值

這個方法可以傳回標準傳回值E_INVALIDARG和S_OK。

備註

這個方法會復原 呼叫 IRunningObjectTable::Register 的效果,移除 Moniker 和該 Moniker 所識別物件的指標。

來電者的附註

Moniker 提供者 (出識別其物件的Monikers,讓其他人能夠存取它們) 必須呼叫 Revoke 方法,以在停止執行時撤銷其對象的註冊。 它之前必須呼叫 IRunningObjectTable::Register ,並儲存該方法傳回的標識符;它會在呼叫 Revoke 時使用該標識碼。

最常見的Moniker提供者類型是複合文件連結來源。 這包括支援連結至其檔案的伺服器應用程式, (或檔) 部分,以及支持連結至其檔案內嵌的容器應用程式。 不支援連結的伺服器應用程式也可以使用 ROT 來與支援連結至內嵌的容器應用程式合作。

如果您要撰寫容器應用程式,則必須在檔案關閉時撤銷檔的註冊。 您也必須撤銷文件的註冊,再重新註冊檔重新命名。

如果您要撰寫伺服器應用程式,則必須在關閉物件時撤銷對象的註冊。 在重新命名物件的容器檔時,您也必須撤銷對象的註冊, (請參閱 IOleObject::SetMoniker) 。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 objidl.h

另請參閱

IRunningObjectTable