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 |