ISecurityIdentityColl
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
呼び出し元のアイデンティティを表すセキュリティ情報のコレクションへのアクセスを提供します。このコレクションで利用できる項目は、SID、アカウント名、認証サービス、認証レベル、および偽装レベルです。
メソッド 3
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
セキュリティアイデンティティコレクション内のプロパティの数を取得します。
| plCount | INT* | out | セキュリティアイデンティティコレクション内のプロパティの数。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。
セキュリティアイデンティティコレクション内の指定されたプロパティを取得します。
| name | LPWSTR | in | 取得するプロパティの名前。利用可能なプロパティについては「解説」を参照してください。 |
| pItem | VARIANT* | out | 取得されたプロパティへの参照。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。
解説(Remarks)
このコレクションはセキュリティアイデンティティを表し、現在の呼び出しで終わる一連の呼び出しの中の特定の呼び出し元に関する情報を提供します。セキュリティアイデンティティコレクション内の各項目について、次の表に説明、取得に使用するインデックス名、および項目の戻りデータ型を示します。
| 項目 | 説明 | インデックス名 | 戻り値の型 |
|---|---|---|---|
| SID | 呼び出し元のセキュリティ識別子。 | "SID" | V_ARRAY |
| アカウント名 | 呼び出し元が使用しているアカウント名。 | "AccountName" | V_BSTR |
| 認証サービス | 呼び出し元が使用する認証サービス。NTLMSSP、Kerberos、SSL など。 | "AuthenticationService" | V_I4 |
| 偽装レベル | 偽装レベル。呼び出し元がクライアントに代わって行動するために与えられた権限の大きさを示します。 | "ImpersonationLevel" | V_I4 |
| 認証レベル | 呼び出し元が使用する認証レベル。通話中に与えられる保護の程度を示します。 | "AuthenticationLevel" | V_I4 |
セキュリティアイデンティティコレクションの列挙子を取得します。
| ppEnum | IUnknown** | out | 返される IEnumVARIANT インターフェイスへの参照。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ISecurityIdentityColl "{CAFC823C-B441-11D1-B82B-0000F8757E2A}" #usecom global ISecurityIdentityColl IID_ISecurityIdentityColl "{}" #comfunc global ISecurityIdentityColl_get_Count 7 var #comfunc global ISecurityIdentityColl_get_Item 8 wstr,var #comfunc global ISecurityIdentityColl_get__NewEnum 9 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ISecurityIdentityColl "{CAFC823C-B441-11D1-B82B-0000F8757E2A}" #usecom global ISecurityIdentityColl IID_ISecurityIdentityColl "{}" #comfunc global ISecurityIdentityColl_get_Count 7 sptr #comfunc global ISecurityIdentityColl_get_Item 8 wstr,sptr #comfunc global ISecurityIdentityColl_get__NewEnum 9 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。