ホーム › System.EventNotificationService › ISensLogon2

ISensLogon2

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDd597bab4-5b9f-11d1-8dd2-00aa004abd5e継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

ISensLogon2 インターフェイスは、SENS によって発生するログオンイベントを処理します。

メソッド 5

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT Logon(LPWSTR bstrUserName, DWORD dwSessionId)

Logon メソッドは、ユーザーがログオンしたことをアプリケーションに通知します。(ISensLogon2.Logon)

bstrUserName	LPWSTR	in	ログオンしたユーザーの名前。
dwSessionId	DWORD	in	セッションのセッション識別子。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値	説明
S_OK	メソッドが正常に返されました。

解説(Remarks)

SENS は、ユーザーがログオンしたことをアプリケーションに通知するためにこのメソッドを呼び出します。

vtbl 8 HRESULT Logoff(LPWSTR bstrUserName, DWORD dwSessionId)

Logoff メソッドは、ユーザーがログオフしたことをアプリケーションに通知します。(ISensLogon2.Logoff)

bstrUserName	LPWSTR	in	ログオフするユーザーの名前。
dwSessionId	DWORD	in	セッションのセッション識別子。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値	説明
S_OK	メソッドが正常に返されました。

解説(Remarks)

SENS は、ユーザーがログオフしたことをアプリケーションに通知するためにこのメソッドを呼び出します。

vtbl 9 HRESULT SessionDisconnect(LPWSTR bstrUserName, DWORD dwSessionId)

SessionDisconnect メソッドは、ユーザーの簡易切り替え(Fast User Switching)セッションまたはリモートデスクトップ接続から切断するために使用されます。このメソッドを使用するとセッションが切断されるため、セッションからのログオフとは異なります。

bstrUserName	LPWSTR	in	現在のユーザーの名前。
dwSessionId	DWORD	in	セッションのセッション識別子。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値	説明
S_OK	メソッドが正常に返されました。

解説(Remarks)

SENS は、セッションが切断されたことをアプリケーションに通知するためにこのメソッドを呼び出します。

vtbl 10 HRESULT SessionReconnect(LPWSTR bstrUserName, DWORD dwSessionId)

セッションが再接続されました。SessionReconnect メソッドは、ユーザーの簡易切り替え(Fast User Switching)セッションまたはリモートデスクトップ接続に再接続するときに使用されます。これは、新しいセッションへのログオンとは異なります。

bstrUserName	LPWSTR	in	現在のユーザーの名前。
dwSessionId	DWORD	in	セッションのセッション識別子。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値	説明
S_OK	メソッドが正常に返されました。

解説(Remarks)

SENS は、セッションが再接続されたことをアプリケーションに通知するためにこのメソッドを呼び出します。

vtbl 11 HRESULT PostShell(LPWSTR bstrUserName, DWORD dwSessionId)

PostShell メソッドは、ユーザーがログオンして Windows エクスプローラーが実行されているときに使用します。このメソッドは Logon メソッドとは異なります。Logon はログオン後にシェルがまだ実行されていない可能性がある時点で呼び出されるためです。

bstrUserName	LPWSTR	in	現在のユーザーの名前。
dwSessionId	DWORD	in	セッションのセッション識別子。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値	説明
S_OK	メソッドが正常に返されました。

解説(Remarks)

SENS は、ユーザーがログオンして Windows エクスプローラー(シェル)が実行されていることをアプリケーションに通知するためにこのメソッドを呼び出します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_ISensLogon2 "{D597BAB4-5B9F-11D1-8DD2-00AA004ABD5E}"
#usecom global ISensLogon2 IID_ISensLogon2 "{}"
#comfunc global ISensLogon2_Logon              7 wstr,int
#comfunc global ISensLogon2_Logoff             8 wstr,int
#comfunc global ISensLogon2_SessionDisconnect  9 wstr,int
#comfunc global ISensLogon2_SessionReconnect   10 wstr,int
#comfunc global ISensLogon2_PostShell          11 wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。