ホーム › Security.Cryptography.Certificates › ICertEncodeAltName2

ICertEncodeAltName2

COMIDispatch (デュアル)

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

IIDf67fe177-5ef1-4535-b4ce-29df15e2e0c3継承元ICertEncodeAltName呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl14

メソッド 4

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

vtbl 14 HRESULT DecodeBlob(LPWSTR strEncodedData, EncodingType Encoding)

strEncodedData	LPWSTR	in	デコードする代替名情報のエンコード済みデータを文字列として渡す。
Encoding	EncodingType	in	入力データのエンコード形式を指定する EncodingType 値である。

vtbl 15 HRESULT EncodeBlob(EncodingType Encoding, LPWSTR* pstrEncodedData)

Encoding	EncodingType	in	出力データに適用するエンコード形式を指定する EncodingType 値である。
pstrEncodedData	LPWSTR*	out	エンコードされた代替名情報を指定形式の文字列として受け取る LPWSTR へのポインタである。

vtbl 16 HRESULT GetNameBlob(INT NameIndex, EncodingType Encoding, LPWSTR* pstrName)

NameIndex	INT	in	取得する代替名エントリの 0 始まりのインデックスを指定する。
Encoding	EncodingType	in	出力データに適用するエンコード形式を指定する EncodingType 値である。
pstrName	LPWSTR*	out	指定エントリの代替名を指定形式でエンコードした文字列として受け取る LPWSTR へのポインタである。

vtbl 17 HRESULT SetNameEntryBlob(INT NameIndex, INT NameChoice, LPWSTR strName, EncodingType Encoding)

NameIndex	INT	in	設定する代替名エントリの 0 始まりのインデックスを指定する。
NameChoice	INT	in	設定する名前の種別を指定する INT 値である。
strName	LPWSTR	in	代替名エントリの値をエンコード済み文字列として渡す。
Encoding	EncodingType	in	渡す strName のエンコード形式を指定する EncodingType 値である。

HSP用 COM定義

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

出力引数:

#define global IID_ICertEncodeAltName2 "{F67FE177-5EF1-4535-B4CE-29DF15E2E0C3}"
#usecom global ICertEncodeAltName2 IID_ICertEncodeAltName2 "{}"
#comfunc global ICertEncodeAltName2_DecodeBlob        14 wstr,int
#comfunc global ICertEncodeAltName2_EncodeBlob        15 int,var
#comfunc global ICertEncodeAltName2_GetNameBlob       16 int,int,var
#comfunc global ICertEncodeAltName2_SetNameEntryBlob  17 int,int,wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ICertEncodeAltName2 "{F67FE177-5EF1-4535-B4CE-29DF15E2E0C3}"
#usecom global ICertEncodeAltName2 IID_ICertEncodeAltName2 "{}"
#comfunc global ICertEncodeAltName2_DecodeBlob        14 wstr,int
#comfunc global ICertEncodeAltName2_EncodeBlob        15 int,sptr
#comfunc global ICertEncodeAltName2_GetNameBlob       16 int,int,sptr
#comfunc global ICertEncodeAltName2_SetNameEntryBlob  17 int,int,wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。