ホーム › System.ComponentServices › IComThreadEvents
IComThreadEvents
COM公式ドキュメント
シングルスレッドアパートメント(STA)が作成または終了されたとき、およびアパートメントスレッドが割り当てられたときにサブスクライバーに通知します。
メソッド 11
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnThreadStart(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, DWORD dwThread, DWORD dwTheadCnt)
シングルスレッドアパートメント(STA)スレッドが開始されたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| ThreadID | ULONGLONG | in | 一意のスレッド識別子。 |
| dwThread | DWORD | in | Windows スレッド識別子。 |
| dwTheadCnt | DWORD | in | STA スレッドプール内のスレッド数。 |
戻り値
このメソッドからの戻り値はユーザーが検証します。
vtbl 4 HRESULT OnThreadTerminate(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, DWORD dwThread, DWORD dwTheadCnt)
シングルスレッドアパートメント(STA)スレッドが終了されたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| ThreadID | ULONGLONG | in | 一意のスレッド識別子。 |
| dwThread | DWORD | in | Windows スレッド識別子。 |
| dwTheadCnt | DWORD | in | STA スレッドプール内のスレッド数。 |
戻り値
このメソッドからの戻り値はユーザーが検証します。
vtbl 5 HRESULT OnThreadBindToApartment(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG AptID, DWORD dwActCnt, DWORD dwLowCnt)
実行するアパートメントスレッドを持たないシングルスレッドアパートメント(STA)スレッドに対してアパートメントスレッドが割り当てられたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| ThreadID | ULONGLONG | in | 一意のスレッド識別子。 |
| AptID | ULONGLONG | in | アパートメント識別子。 |
| dwActCnt | DWORD | in | このアパートメントにバインドされているアクティビティの数。 |
| dwLowCnt | DWORD | in | このパラメーターは予約済みです。 |
戻り値
このメソッドからの戻り値はユーザーが検証します。
vtbl 6 HRESULT OnThreadUnBind(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG AptID, DWORD dwActCnt)
構成済みコンポーネントの有効期間が終了し、アパートメントスレッドのアクティビティ数をデクリメントできるときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| ThreadID | ULONGLONG | in | 一意のスレッド識別子。 |
| AptID | ULONGLONG | in | アパートメント識別子。 |
| dwActCnt | DWORD | in | アパートメントスレッド上の現在のアクティビティの数。 |
戻り値
このメソッドからの戻り値はユーザーが検証します。
vtbl 7 HRESULT OnThreadWorkEnque(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG MsgWorkID, DWORD QueueLen)
| pInfo | COMSVCSEVENTINFO* | in | イベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。 |
| ThreadID | ULONGLONG | in | 対象スレッドの識別子を渡す。 |
| MsgWorkID | ULONGLONG | in | キューに追加された作業項目(メッセージ)の識別子を渡す。 |
| QueueLen | DWORD | in | キューの現在の長さを渡す。 |
vtbl 8 HRESULT OnThreadWorkPrivate(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG MsgWorkID)
| pInfo | COMSVCSEVENTINFO* | in | イベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。 |
| ThreadID | ULONGLONG | in | 対象スレッドの識別子を渡す。 |
| MsgWorkID | ULONGLONG | in | 処理対象のプライベート作業項目の識別子を渡す。 |
vtbl 9 HRESULT OnThreadWorkPublic(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG MsgWorkID, DWORD QueueLen)
| pInfo | COMSVCSEVENTINFO* | in | イベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。 |
| ThreadID | ULONGLONG | in | 対象スレッドの識別子を渡す。 |
| MsgWorkID | ULONGLONG | in | 処理対象のパブリック作業項目の識別子を渡す。 |
| QueueLen | DWORD | in | キューの現在の長さを渡す。 |
vtbl 10 HRESULT OnThreadWorkRedirect(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG MsgWorkID, DWORD QueueLen, ULONGLONG ThreadNum)
| pInfo | COMSVCSEVENTINFO* | in | イベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。 |
| ThreadID | ULONGLONG | in | 対象スレッドの識別子を渡す。 |
| MsgWorkID | ULONGLONG | in | リダイレクトされた作業項目の識別子を渡す。 |
| QueueLen | DWORD | in | キューの現在の長さを渡す。 |
| ThreadNum | ULONGLONG | in | リダイレクト先のスレッド番号を渡す。 |
vtbl 11 HRESULT OnThreadWorkReject(COMSVCSEVENTINFO* pInfo, ULONGLONG ThreadID, ULONGLONG MsgWorkID, DWORD QueueLen)
| pInfo | COMSVCSEVENTINFO* | in | イベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。 |
| ThreadID | ULONGLONG | in | 対象スレッドの識別子を渡す。 |
| MsgWorkID | ULONGLONG | in | 拒否された作業項目の識別子を渡す。 |
| QueueLen | DWORD | in | キューの現在の長さを渡す。 |
vtbl 12 HRESULT OnThreadAssignApartment(COMSVCSEVENTINFO* pInfo, GUID* guidActivity, ULONGLONG AptID)
アクティビティがアパートメントスレッドに割り当てられたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidActivity | GUID* | in | オブジェクトが作成されるアクティビティの識別子。 |
| AptID | ULONGLONG | in | アパートメント識別子。 |
戻り値
このメソッドからの戻り値はユーザーが検証します。
vtbl 13 HRESULT OnThreadUnassignApartment(COMSVCSEVENTINFO* pInfo, ULONGLONG AptID)
アクティビティがアパートメントスレッドから割り当て解除されたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| AptID | ULONGLONG | in | アパートメント識別子。 |
戻り値
このメソッドからの戻り値はユーザーが検証します。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IComThreadEvents "{683130A5-2E50-11D2-98A5-00C04F8EE1C4}" #usecom global IComThreadEvents IID_IComThreadEvents "{}" #comfunc global IComThreadEvents_OnThreadStart 3 var,int64,int,int #comfunc global IComThreadEvents_OnThreadTerminate 4 var,int64,int,int #comfunc global IComThreadEvents_OnThreadBindToApartment 5 var,int64,int64,int,int #comfunc global IComThreadEvents_OnThreadUnBind 6 var,int64,int64,int #comfunc global IComThreadEvents_OnThreadWorkEnque 7 var,int64,int64,int #comfunc global IComThreadEvents_OnThreadWorkPrivate 8 var,int64,int64 #comfunc global IComThreadEvents_OnThreadWorkPublic 9 var,int64,int64,int #comfunc global IComThreadEvents_OnThreadWorkRedirect 10 var,int64,int64,int,int64 #comfunc global IComThreadEvents_OnThreadWorkReject 11 var,int64,int64,int #comfunc global IComThreadEvents_OnThreadAssignApartment 12 var,var,int64 #comfunc global IComThreadEvents_OnThreadUnassignApartment 13 var,int64 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IComThreadEvents "{683130A5-2E50-11D2-98A5-00C04F8EE1C4}" #usecom global IComThreadEvents IID_IComThreadEvents "{}" #comfunc global IComThreadEvents_OnThreadStart 3 sptr,int64,int,int #comfunc global IComThreadEvents_OnThreadTerminate 4 sptr,int64,int,int #comfunc global IComThreadEvents_OnThreadBindToApartment 5 sptr,int64,int64,int,int #comfunc global IComThreadEvents_OnThreadUnBind 6 sptr,int64,int64,int #comfunc global IComThreadEvents_OnThreadWorkEnque 7 sptr,int64,int64,int #comfunc global IComThreadEvents_OnThreadWorkPrivate 8 sptr,int64,int64 #comfunc global IComThreadEvents_OnThreadWorkPublic 9 sptr,int64,int64,int #comfunc global IComThreadEvents_OnThreadWorkRedirect 10 sptr,int64,int64,int,int64 #comfunc global IComThreadEvents_OnThreadWorkReject 11 sptr,int64,int64,int #comfunc global IComThreadEvents_OnThreadAssignApartment 12 sptr,sptr,int64 #comfunc global IComThreadEvents_OnThreadUnassignApartment 13 sptr,int64 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。