ホーム › Security.Cryptography.Certificates › IX509ExtensionTemplate

IX509ExtensionTemplate

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IID728ab312-217d-11da-b2a4-000e7bbb2b09継承元IX509Extension呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl12

公式ドキュメント

CertificateTemplate 拡張を初期化または取得するために使用できるメソッドとプロパティを定義します。

メソッド 5

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

vtbl 12 HRESULT InitializeEncode(IObjectId* pTemplateOid, INT MajorVersion, INT MinorVersion)

テンプレートのオブジェクト識別子 (OID) と、メジャーおよびマイナーのバージョン番号から拡張を初期化します。

pTemplateOid	IObjectId*	inoptional	テンプレート OID を表す IObjectId インターフェイスへのポインター。
MajorVersion	INT	in	テンプレートのメジャーバージョン番号を格納する LONG 変数。既定値はゼロ (0) です。
MinorVersion	INT	in	テンプレートのマイナーバージョン番号を格納する LONG 変数。既定値はゼロ (0) です。

戻り値

関数が成功した場合、関数は S_OK を返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。可能な値には次の表に示すものが含まれますが、これらに限定されません。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

リターンコード/値	説明
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

解説(Remarks)

IX509ExtensionTemplate オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。この 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドを使用すると、生データから Distinguished Encoding Rules (DER) でエンコードされた Abstract Syntax Notation One (ASN.1) 拡張オブジェクトを構築できます。また、InitializeDecode メソッドを使用すると、エンコードされたオブジェクトから生データを初期化できます。

この拡張については、次のプロパティを取得できます:

Critical プロパティは、拡張が critical (重要) かどうかを示します。このプロパティは指定することもできます。
ObjectId プロパティは OID を取得します。
MajorVersion および MinorVersion プロパティはバージョン情報を取得します。
TemplateOid プロパティはテンプレートの OID を取得します。

IX509ExtensionBasicConstraints オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。この 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドを使用すると、生データからエンコードされた ASN.1 構造体を構築できます。また、InitializeDecode メソッドを使用すると、エンコードされた ASN.1 構造体から生データを初期化できます。拡張の生データは、MajorVersion、MinorVersion、および TemplateOid プロパティを呼び出すことで取得できます。

vtbl 13 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)

拡張の値を格納する DER エンコードされたバイト配列から拡張を初期化します。

Encoding	EncodingType	in	strEncodedData パラメーターに適用される Unicode エンコードの種類を指定する EncodingType 列挙値。
strEncodedData	LPWSTR	in	DER エンコードされた拡張を格納する BSTR 変数。

戻り値

関数が成功した場合、関数は S_OK を返します。

リターンコード/値	説明
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

解説(Remarks)

CertificateTemplate 拡張を格納する Distinguished Encoding Rules (DER) でエンコードされた Abstract Syntax Notation One (ASN.1) オブジェクトがある場合は、このメソッドを使用できます。DER エンコードされたオブジェクトは Unicode エンコードされた文字列で指定する必要があります。詳細については、IBinaryConverter インターフェイスを参照してください。

IX509ExtensionTemplate オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。この 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドを使用すると、生データから DER エンコードされた ASN.1 拡張オブジェクトを構築できます。また、InitializeDecode メソッドを使用すると、エンコードされたオブジェクトから生データを初期化できます。

この拡張については、次のプロパティを取得できます:

Critical プロパティは、拡張が critical (重要) かどうかを示します。このプロパティは指定することもできます。
ObjectId プロパティはオブジェクト識別子 (OID) を取得します。
MajorVersion および MinorVersion プロパティはバージョン情報を取得します。
TemplateOid プロパティはテンプレートの OID を取得します。

vtbl 14 HRESULT get_TemplateOid(IObjectId** ppValue)

テンプレートのオブジェクト識別子 (OID) を取得します。

ppValue

IObjectId**

out

拡張に格納された証明書テンプレートの OID を受け取るインターフェイスポインタへのポインタである。

解説(Remarks)

IX509ExtensionTemplate オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。この拡張については、次の追加のプロパティを取得できます:

Critical プロパティは、拡張が critical (重要) かどうかを示します。このプロパティは指定することもできます。
ObjectId プロパティは OID を取得します。
MajorVersion および MinorVersion プロパティはバージョン情報を取得します。

vtbl 15 HRESULT get_MajorVersion(INT* pValue)

証明書テンプレートの最小メジャーバージョン番号を取得します。

pValue

INT*

out

テンプレートのメジャーバージョンを受け取る INT へのポインタである。

解説(Remarks)

Critical プロパティは、拡張が critical (重要) かどうかを示します。このプロパティは指定することもできます。
ObjectId プロパティはオブジェクト識別子 (OID) を取得します。
MinorVersion プロパティはバージョン情報を取得します。
TemplateOid プロパティはテンプレートの OID を取得します。

vtbl 16 HRESULT get_MinorVersion(INT* pValue)

証明書テンプレートの最小マイナーバージョン番号を取得します。

pValue

INT*

out

テンプレートのマイナーバージョンを受け取る INT へのポインタである。

解説(Remarks)

Critical プロパティは、拡張が critical (重要) かどうかを示します。このプロパティは指定することもできます。
ObjectId プロパティはオブジェクト識別子 (OID) を取得します。
MajorVersion プロパティはバージョン情報を取得します。
TemplateOid プロパティはテンプレートの OID を取得します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IX509ExtensionTemplate "{728AB312-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509ExtensionTemplate IID_IX509ExtensionTemplate "{}"
#comfunc global IX509ExtensionTemplate_InitializeEncode  12 sptr,int,int
#comfunc global IX509ExtensionTemplate_InitializeDecode  13 int,wstr
#comfunc global IX509ExtensionTemplate_get_TemplateOid   14 sptr
#comfunc global IX509ExtensionTemplate_get_MajorVersion  15 var
#comfunc global IX509ExtensionTemplate_get_MinorVersion  16 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IX509ExtensionTemplate "{728AB312-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509ExtensionTemplate IID_IX509ExtensionTemplate "{}"
#comfunc global IX509ExtensionTemplate_InitializeEncode  12 sptr,int,int
#comfunc global IX509ExtensionTemplate_InitializeDecode  13 int,wstr
#comfunc global IX509ExtensionTemplate_get_TemplateOid   14 sptr
#comfunc global IX509ExtensionTemplate_get_MajorVersion  15 sptr
#comfunc global IX509ExtensionTemplate_get_MinorVersion  16 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。