ホーム › Security.Cryptography.Certificates › IOCSPPropertyCollection

IOCSPPropertyCollection

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IID2597c18d-54e6-4b74-9fa9-a6bfda99cbbe継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

Online Certificate Status Protocol (OCSP) サービスの構成可能な属性プロパティ(名前と値のペア)のセットを表します。

解説(Remarks)

IOCSPPropertyCollection には、次の項目に関する属性が含まれます。

スレッド数およびキャッシュエントリ数を含む Web プロキシ設定
開始/停止、構成変更、セキュリティ変更、要求イベントを含む監査設定
IOCSPAdmin インターフェイスの ACE を含むセキュリティ設定

すべての OCSP 属性情報は、次のレジストリキーに格納されます。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\OCSPSvc\Responder

OCSP 属性は、すべての CA 構成に対する OCSP レスポンダーサービスの動作を制御します。CA 構成の詳細については、IOCSPCAConfiguration インターフェイスのトピックを参照してください。

メソッド 8

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

vtbl 7 HRESULT get__NewEnum(IUnknown** ppVal)

プロパティセットの列挙子を取得します。

ppVal

IUnknown**

out

コレクションを反復処理するための列挙子 (IEnumVARIANT) を受け取る IUnknown インターフェイスポインタへのポインタである。

vtbl 8 HRESULT get_Item(INT Index, VARIANT* pVal)

プロパティセット内でインデックスによって識別されるプロパティを取得します。

Index	INT	in	取得する項目の 0 起点のインデックスを指定する。
pVal	VARIANT*	out	指定したインデックスのプロパティを受け取る VARIANT へのポインタである。

vtbl 9 HRESULT get_Count(INT* pVal)

プロパティセット内のプロパティの数を取得します。

pVal

INT*

out

コレクション内のプロパティ数を受け取る INT へのポインタである。

vtbl 10 HRESULT get_ItemByName(LPWSTR bstrPropName, VARIANT* pVal)

プロパティセット内で名前によって識別されるプロパティを取得します。

bstrPropName	LPWSTR	in	取得するプロパティの名前を指定する。
pVal	VARIANT*	out	指定した名前のプロパティを受け取る VARIANT へのポインタである。

vtbl 11 HRESULT CreateProperty(LPWSTR bstrPropName, VARIANT* pVarPropValue, IOCSPProperty** ppVal)

新しいプロパティを作成し、プロパティセットに追加します。

bstrPropName

LPWSTR

新しいプロパティオブジェクトの名前を含む文字列。

pVarPropValue

VARIANT*

C++	新しいプロパティオブジェクトへのポインター。
VB	新しいプロパティオブジェクト。

ppVal

IOCSPProperty**

out

新しく作成されたオブジェクトの IOCSPProperty インターフェイスへのポインター。

戻り値

C++

メソッドが成功した場合、S_OK を返します。

メソッドが失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

VB

新しく作成されたオブジェクトの IOCSPProperty インターフェイス。

vtbl 12 HRESULT DeleteProperty(LPWSTR bstrPropName)

名前付きプロパティをプロパティセットから削除します。

bstrPropName

LPWSTR

削除するプロパティの名前を含む文字列。

vtbl 13 HRESULT InitializeFromProperties(VARIANT* pVarProperties)

既存のサーバー構成に含まれるプロパティからプロパティセットを作成します。

pVarProperties

VARIANT*

C++	プロパティ値を含む配列へのポインター。各配列要素は、プロパティ名 BSTR と値 VARIANT を含む VARIANT 配列です。
VB	プロパティ値を含む配列。各配列要素は、プロパティ名 String と値 Variant を含む Variant 配列です。

戻り値

VB

メソッドが成功した場合、S_OK を返します。

メソッドが失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

メソッドが E_UNEXPECTED を返した場合、pVarProperties パラメーターが指す配列に重複したプロパティが含まれていました。

メソッドが DISP_E_ARRAYISLOCKED を返した場合、pVarProperties パラメーターが指す配列はロックされています。

vtbl 14 HRESULT GetAllProperties(VARIANT* pVarProperties)

プロパティセット内のすべてのプロパティを取得します。

pVarProperties

VARIANT*

out

プロパティを名前と値のペアとして含むセーフ配列へのポインター。

この配列は、各要素が VARIANT 型である 2 次元配列です。配列には、コレクション内の名前付きプロパティごとに 1 行が含まれます。各行には、プロパティ名とプロパティ値の 2 つの列が含まれます。

戻り値

C++

メソッドが成功した場合、S_OK を返します。

メソッドが失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

VB

プロパティを名前と値のペアとして含むセーフ配列。

この配列は、各要素が Variant 型である 2 次元配列です。配列には、コレクション内の名前付きプロパティごとに 1 行が含まれます。各行には、プロパティ名とプロパティ値の 2 つの列が含まれます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IOCSPPropertyCollection "{2597C18D-54E6-4B74-9FA9-A6BFDA99CBBE}"
#usecom global IOCSPPropertyCollection IID_IOCSPPropertyCollection "{F935A528-BA8A-4DD9-BA79-F283275CB2DE}"
#comfunc global IOCSPPropertyCollection_get__NewEnum              7 sptr
#comfunc global IOCSPPropertyCollection_get_Item                  8 int,var
#comfunc global IOCSPPropertyCollection_get_Count                 9 var
#comfunc global IOCSPPropertyCollection_get_ItemByName            10 wstr,var
#comfunc global IOCSPPropertyCollection_CreateProperty            11 wstr,var,sptr
#comfunc global IOCSPPropertyCollection_DeleteProperty            12 wstr
#comfunc global IOCSPPropertyCollection_InitializeFromProperties  13 var
#comfunc global IOCSPPropertyCollection_GetAllProperties          14 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IOCSPPropertyCollection "{2597C18D-54E6-4B74-9FA9-A6BFDA99CBBE}"
#usecom global IOCSPPropertyCollection IID_IOCSPPropertyCollection "{F935A528-BA8A-4DD9-BA79-F283275CB2DE}"
#comfunc global IOCSPPropertyCollection_get__NewEnum              7 sptr
#comfunc global IOCSPPropertyCollection_get_Item                  8 int,sptr
#comfunc global IOCSPPropertyCollection_get_Count                 9 sptr
#comfunc global IOCSPPropertyCollection_get_ItemByName            10 wstr,sptr
#comfunc global IOCSPPropertyCollection_CreateProperty            11 wstr,sptr,sptr
#comfunc global IOCSPPropertyCollection_DeleteProperty            12 wstr
#comfunc global IOCSPPropertyCollection_InitializeFromProperties  13 sptr
#comfunc global IOCSPPropertyCollection_GetAllProperties          14 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。