IX509ExtensionBasicConstraints::InitializeEncode メソッド (certenroll.h)

InitializeEncode メソッドは、証明書のサブジェクトが証明機関 (CA) であるかどうかを示すブール値と、下位 CA チェーンの深さを含む整数から拡張機能を初期化します。

構文

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

パラメーター

[in] IsCA

証明書 の サブジェクトが CA であるかどうかを示すVARIANT_BOOL変数。

[in] PathLenConstraint

チェーン内の証明書の最大数を含む LONG 変数。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

このメソッドは、名前コレクションをXCN_OID_BASIC_CONSTRAINTS2 (2.5.29.19) オブジェクト識別子 (OID) に関連付け、 識別エンコード規則 (DER) を使用してエンコードします。

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

この拡張機能の次のプロパティを取得できます。

• Critical プロパティは、拡張機能が重要であるかどうかを識別します。 このプロパティを指定することもできます。
• ObjectId プロパティは、OID を取得します。
• IsCA プロパティは、証明書のサブジェクトを証明機関にできるかどうかを識別します。
• PathLenConstraint プロパティは、下位証明機関チェーンの深さを識別します。

Requirements

こちらも参照ください

IX509ExtensionBasicConstraints