Win32 API 日本語リファレンス
ホームSecurity.Cryptography.Certificates › IAlternativeName

IAlternativeName

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID728ab313-217d-11da-b2a4-000e7bbb2b09継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 7

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

vtbl 7 HRESULT InitializeFromString(AlternativeNameType Type, LPWSTR strValue)
TypeAlternativeNameTypein別名の種類を指定する AlternativeNameType である。
strValueLPWSTRin別名の値を文字列で指定する。
vtbl 8 HRESULT InitializeFromRawData(AlternativeNameType Type, EncodingType Encoding, LPWSTR strRawData)
TypeAlternativeNameTypein別名の種類を指定する AlternativeNameType である。
EncodingEncodingTypein入力データのエンコード形式を指定する EncodingType である。
strRawDataLPWSTRin別名の生データ (エンコード済み) を指定する。
vtbl 9 HRESULT InitializeFromOtherName(IObjectId* pObjectId, EncodingType Encoding, LPWSTR strRawData, VARIANT_BOOL ToBeWrapped)
pObjectIdIObjectId*inoptionalOtherName 形式の別名の OID を表す IObjectId へのポインタである。
EncodingEncodingTypein入力データのエンコード形式を指定する EncodingType である。
strRawDataLPWSTRin別名の生データ (エンコード済み) を指定する。
ToBeWrappedVARIANT_BOOLin値を ASN.1 でラップする必要があるかどうかを指定する VARIANT_BOOL である。
vtbl 10 HRESULT get_Type(AlternativeNameType* pValue)
pValueAlternativeNameType*out別名の種類を受け取る AlternativeNameType へのポインタである。
vtbl 11 HRESULT get_StrValue(LPWSTR* pValue)
pValueLPWSTR*out別名の値 (文字列表現) を受け取る文字列ポインタである。
vtbl 12 HRESULT get_ObjectId(IObjectId** ppValue)
ppValueIObjectId**outOtherName 形式の別名の OID を表す IObjectId オブジェクトを受け取るインターフェイスポインタへのポインタである。
vtbl 13 HRESULT get_RawData(EncodingType Encoding, LPWSTR* pValue)
EncodingEncodingTypein出力データのエンコード形式を指定する EncodingType である。
pValueLPWSTR*out別名の生データ (エンコード済み) を受け取る文字列ポインタである。

HSP用 COM定義

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

出力引数:
#define global IID_IAlternativeName "{728AB313-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IAlternativeName IID_IAlternativeName "{}"
#comfunc global IAlternativeName_InitializeFromString     7 int,wstr
#comfunc global IAlternativeName_InitializeFromRawData    8 int,int,wstr
#comfunc global IAlternativeName_InitializeFromOtherName  9 sptr,int,wstr,int
#comfunc global IAlternativeName_get_Type                 10 var
#comfunc global IAlternativeName_get_StrValue             11 var
#comfunc global IAlternativeName_get_ObjectId             12 sptr
#comfunc global IAlternativeName_get_RawData              13 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。