IRunningObjectTable::Revoke メソッド (objidl.h)
IRunningObjectTable::Register の呼び出しによって以前に登録された実行中のオブジェクト テーブル (ROT) からエントリを削除します。
構文
HRESULT Revoke(
[in] DWORD dwRegister
);
パラメーター
[in] dwRegister
取り消す ROT 項目の ID。
戻り値
このメソッドは、標準の戻り値E_INVALIDARGとS_OKを返すことができます。
注釈
このメソッドは 、IRunningObjectTable::Register の呼び出しの効果を取り消し、モニカーとそのモニカーによって識別されるオブジェクトへのポインターの両方を削除します。
呼び出し元へのメモ
モニカー プロバイダー (オブジェクトを識別して他のユーザーがアクセスできるようにモニカーを提供する) は 、Revoke メソッドを呼び出して、オブジェクトの実行が停止したときにオブジェクトの登録を取り消す必要があります。 以前に IRunningObjectTable::Register を呼び出し、そのメソッドによって返される識別子を格納している必要があります。Revoke を呼び出すときに、その識別子が使用 されます。モニカー プロバイダーの最も一般的な種類は、複合ドキュメント リンク ソースです。 これには、ドキュメント (またはドキュメントの一部) へのリンクをサポートするサーバー アプリケーションと、ドキュメント内の埋め込みへのリンクをサポートするコンテナー アプリケーションが含まれます。 リンクをサポートしていないサーバー アプリケーションは、ROT を使用して、埋め込みへのリンクをサポートするコンテナー アプリケーションと連携することもできます。
コンテナー アプリケーションを作成する場合は、ドキュメントが閉じられたときにドキュメントの登録を取り消す必要があります。 また、名前が変更されたときに再登録する前に、ドキュメントの登録を取り消す必要があります。
サーバー アプリケーションを作成する場合は、オブジェクトが閉じられたときにオブジェクトの登録を取り消す必要があります。 また、コンテナー ドキュメントの名前が変更されたときに再登録する前に、オブジェクトの登録を取り消す必要があります ( 「IOleObject::SetMoniker」を参照してください)。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |