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

IX509CertificateRequestPkcs10V3

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID54ea9942-3d66-4530-b76e-7c9170d3ec52継承元IX509CertificateRequestPkcs10V2呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl65

公式ドキュメント

IX509CertificateRequestPkcs10V3 インターフェイスは PKCS を表します

メソッド 11

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

vtbl 65 HRESULT get_AttestPrivateKey(VARIANT_BOOL* pValue)

作成された秘密キーの構成証明(アテステーション)が必要な場合は true、それ以外の場合は false です。true の場合は、AttestationEncryptionCertificate プロパティが設定されていることが求められます。(Get)

pValueVARIANT_BOOL*out秘密鍵の構成証明(キーアテステーション)を要求するかどうかを表す VARIANT_BOOL を受け取るポインタである。
vtbl 66 HRESULT put_AttestPrivateKey(VARIANT_BOOL Value)

作成された秘密キーの構成証明(アテステーション)が必要な場合は true、それ以外の場合は false です。true の場合は、AttestationEncryptionCertificate プロパティが設定されていることが求められます。(Put)

ValueVARIANT_BOOLin秘密鍵の構成証明(キーアテステーション)を要求するかどうかを VARIANT_BOOL で指定する。
vtbl 67 HRESULT get_AttestationEncryptionCertificate(EncodingType Encoding, LPWSTR* pValue)

クライアントからの EKPUB 値および EKCERT 値を暗号化するために使用する証明書です。このプロパティには、信頼されたマシンのルートまでチェーンする有効な証明書を設定する必要があります。(Get)

EncodingEncodingTypein取得する構成証明暗号化証明書文字列のエンコーディング種別を指定する EncodingType 列挙値である。
pValueLPWSTR*outキーアテステーションの暗号化に使用する証明書を指定エンコーディングの文字列として受け取るポインタである。
vtbl 68 HRESULT put_AttestationEncryptionCertificate(EncodingType Encoding, LPWSTR Value)

クライアントからの EKPUB 値および EKCERT 値を暗号化するために使用する証明書です。このプロパティには、信頼されたマシンのルートまでチェーンする有効な証明書を設定する必要があります。(Put)

EncodingEncodingTypein渡す構成証明暗号化証明書文字列のエンコーディング種別を指定する EncodingType 列挙値である。
ValueLPWSTRinキーアテステーションの暗号化に使用する証明書を指定エンコーディングの文字列として渡す。
vtbl 69 HRESULT get_EncryptionAlgorithm(IObjectId** ppValue)

クライアントからの EKPUB 値および EKCERT 値を暗号化するために使用する暗号化アルゴリズムです。(Get)

ppValueIObjectId**out暗号化に使用するアルゴリズムを表す IObjectId オブジェクトを受け取るポインタである。
vtbl 70 HRESULT put_EncryptionAlgorithm(IObjectId* pValue)

クライアントからの EKPUB 値および EKCERT 値を暗号化するために使用する暗号化アルゴリズムです。(Put)

pValueIObjectId*inoptional暗号化に使用するアルゴリズムを表す IObjectId オブジェクトを渡す。
vtbl 71 HRESULT get_EncryptionStrength(INT* pValue)

暗号化に使用する EncryptionAlgorithm のビット長を指定します。EncryptionAlgorithm が 1 つのビット長のみをサポートしている場合は、EncryptionStrength プロパティに値を指定する必要はありません。(Get)

pValueINT*out暗号化の強度(鍵長などのビット数)を表す INT を受け取るポインタである。
vtbl 72 HRESULT put_EncryptionStrength(INT Value)

暗号化に使用する EncryptionAlgorithm のビット長を指定します。EncryptionAlgorithm が 1 つのビット長のみをサポートしている場合は、EncryptionStrength プロパティに値を指定する必要はありません。(Put)

ValueINTin暗号化の強度(鍵長などのビット数)を INT で指定する。
vtbl 73 HRESULT get_ChallengePassword(LPWSTR* pValue)

チャレンジ付きの要求を作成するときに使用するパスワードです。チャレンジなしで要求を作成する場合は、ChallengePassword プロパティを設定しないでください。(Get)

pValueLPWSTR*out要求に含まれるチャレンジパスワード文字列を受け取るポインタである。
vtbl 74 HRESULT put_ChallengePassword(LPWSTR Value)

チャレンジ付きの要求を作成するときに使用するパスワードです。チャレンジなしで要求を作成する場合は、ChallengePassword プロパティを設定しないでください。(Put)

ValueLPWSTRin要求に含めるチャレンジパスワードを文字列で指定する。
vtbl 75 HRESULT get_NameValuePairs(IX509NameValuePairs** ppValue)

追加の証明書プロパティ値の名前と値のペアのコレクションです。

ppValueIX509NameValuePairs**out要求に関連付けられた名前と値のペアのコレクション IX509NameValuePairs を受け取るポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IX509CertificateRequestPkcs10V3 "{54EA9942-3D66-4530-B76E-7C9170D3EC52}"
#usecom global IX509CertificateRequestPkcs10V3 IID_IX509CertificateRequestPkcs10V3 "{}"
#comfunc global IX509CertificateRequestPkcs10V3_get_AttestPrivateKey                  65 var
#comfunc global IX509CertificateRequestPkcs10V3_put_AttestPrivateKey                  66 int
#comfunc global IX509CertificateRequestPkcs10V3_get_AttestationEncryptionCertificate  67 int,var
#comfunc global IX509CertificateRequestPkcs10V3_put_AttestationEncryptionCertificate  68 int,wstr
#comfunc global IX509CertificateRequestPkcs10V3_get_EncryptionAlgorithm               69 sptr
#comfunc global IX509CertificateRequestPkcs10V3_put_EncryptionAlgorithm               70 sptr
#comfunc global IX509CertificateRequestPkcs10V3_get_EncryptionStrength                71 var
#comfunc global IX509CertificateRequestPkcs10V3_put_EncryptionStrength                72 int
#comfunc global IX509CertificateRequestPkcs10V3_get_ChallengePassword                 73 var
#comfunc global IX509CertificateRequestPkcs10V3_put_ChallengePassword                 74 wstr
#comfunc global IX509CertificateRequestPkcs10V3_get_NameValuePairs                    75 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。