ホーム › System.ComponentServices › IComObjectEvents
IComObjectEvents
COM公式ドキュメント
Just-In-Time (JIT) アクティベーションされたオブジェクトのインスタンスが作成または解放されたことをサブスクライバーに通知します。
メソッド 6
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnObjectActivate(COMSVCSEVENTINFO* pInfo, ULONGLONG CtxtID, ULONGLONG ObjectID)
オブジェクトが新しい JIT アクティベーションオブジェクトのインスタンスを取得したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| CtxtID | ULONGLONG | in | 現在のコンテキストの GUID。 |
| ObjectID | ULONGLONG | in | JIT アクティベーションされたオブジェクト。 |
戻り値
このメソッドの戻り値はユーザーが確認します。
vtbl 4 HRESULT OnObjectDeactivate(COMSVCSEVENTINFO* pInfo, ULONGLONG CtxtID, ULONGLONG ObjectID)
JIT アクティベーションされたオブジェクトが SetComplete または SetAbort によって解放されたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| CtxtID | ULONGLONG | in | 現在のコンテキストの GUID。 |
| ObjectID | ULONGLONG | in | JIT アクティベーションされたオブジェクト。 |
戻り値
このメソッドの戻り値はユーザーが確認します。
vtbl 5 HRESULT OnDisableCommit(COMSVCSEVENTINFO* pInfo, ULONGLONG CtxtID)
クライアントがコンテキストに対して DisableCommit を呼び出したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| CtxtID | ULONGLONG | in | 現在のコンテキストの GUID。 |
戻り値
このメソッドの戻り値はユーザーが確認します。
vtbl 6 HRESULT OnEnableCommit(COMSVCSEVENTINFO* pInfo, ULONGLONG CtxtID)
クライアントがコンテキストに対して EnableCommit を呼び出したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| CtxtID | ULONGLONG | in | 現在のコンテキストの GUID。 |
戻り値
このメソッドの戻り値はユーザーが確認します。
vtbl 7 HRESULT OnSetComplete(COMSVCSEVENTINFO* pInfo, ULONGLONG CtxtID)
クライアントがコンテキストに対して SetComplete を呼び出したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| CtxtID | ULONGLONG | in | 現在のコンテキストの GUID。 |
戻り値
このメソッドの戻り値はユーザーが確認します。
vtbl 8 HRESULT OnSetAbort(COMSVCSEVENTINFO* pInfo, ULONGLONG CtxtID)
| pInfo | COMSVCSEVENTINFO* | in | イベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。 |
| CtxtID | ULONGLONG | in | SetAbort が呼ばれたオブジェクトのコンテキスト識別子を渡す。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IComObjectEvents "{683130AA-2E50-11D2-98A5-00C04F8EE1C4}" #usecom global IComObjectEvents IID_IComObjectEvents "{}" #comfunc global IComObjectEvents_OnObjectActivate 3 var,int64,int64 #comfunc global IComObjectEvents_OnObjectDeactivate 4 var,int64,int64 #comfunc global IComObjectEvents_OnDisableCommit 5 var,int64 #comfunc global IComObjectEvents_OnEnableCommit 6 var,int64 #comfunc global IComObjectEvents_OnSetComplete 7 var,int64 #comfunc global IComObjectEvents_OnSetAbort 8 var,int64 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IComObjectEvents "{683130AA-2E50-11D2-98A5-00C04F8EE1C4}" #usecom global IComObjectEvents IID_IComObjectEvents "{}" #comfunc global IComObjectEvents_OnObjectActivate 3 sptr,int64,int64 #comfunc global IComObjectEvents_OnObjectDeactivate 4 sptr,int64,int64 #comfunc global IComObjectEvents_OnDisableCommit 5 sptr,int64 #comfunc global IComObjectEvents_OnEnableCommit 6 sptr,int64 #comfunc global IComObjectEvents_OnSetComplete 7 sptr,int64 #comfunc global IComObjectEvents_OnSetAbort 8 sptr,int64 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。