IRunningObjectTable_Revoke

IRunningObjectTable::Register 呼び出しで以前に登録されたエントリをランニングオブジェクトテーブル (ROT) から削除する。

IRunningObjectTable_Revoke this, dwRegister

this : [comobj] IRunningObjectTable インターフェースの COM オブジェクト変数
dwRegister : [int] 取り消す ROT エントリの識別子。

(プラグイン / モジュール : com_misc.dll)

解説

IRunningObjectTable::Register 呼び出しで以前に登録されたエントリをランニングオブジェクトテーブル (ROT)
から削除する。

[戻り値]
このメソッドは標準の戻り値 E_INVALIDARG および S_OK を返すことがある。

[備考]
このメソッドは IRunningObjectTable::Register
の呼び出しの効果を取り消し、モニカーとそのモニカーで識別されるオブジェクトへのポインタの両方を削除する。呼び出し側への注意
モニカープロバイダ (他者がアクセスできるよう、自身のオブジェクトを識別するモニカーを配布する側)
は、実行を停止する際にオブジェクトの登録を取り消すために Revoke メソッドを呼ばなければならない。事前に
IRunningObjectTable::Register を呼び、そのメソッドが返した識別子を保存しておき、Revoke
呼び出し時にその識別子を使用する必要がある。最も一般的なモニカープロバイダは複合ドキュメントのリンクソースである。これには自ドキュメント
(またはその一部)
へのリンクをサポートするサーバアプリケーションや、ドキュメント内の埋め込みへのリンクをサポートするコンテナアプリケーションが含まれる。リンクをサポートしないサーバアプリケーションも、ROT
を用いて埋め込みへのリンクをサポートするコンテナアプリケーションと協調することができる。コンテナアプリケーションを書いている場合、ドキュメントが閉じられるときにその登録を取り消さなければならない。リネームされて再登録する前にもドキュメントの登録を取り消さなければならない。

サーバアプリケーションを書いている場合、オブジェクトが閉じられるときにその登録を取り消さなければならない。コンテナドキュメントがリネームされたときにオブジェクトを再登録する前にも、その登録を取り消さなければならない
(IOleObject::SetMoniker を参照)。

情報