次の方法で共有


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

InitializeDecode メソッドは、拡張値を含むDistinguished Encoding Rules (DER) でエンコードされたバイト配列から拡張を初期化します。 エンコードされたバイト配列は、Unicode でエンコードされた文字列で表されます。

構文

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

パラメーター

[in] Encoding

strEncodedData 値に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。

[in] strEncodedData

DER でエンコードされた拡張機能を含む BSTR 変数。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

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

解説

BASICConstraints 拡張機能を含む DER エンコード抽象構文表記 1 (ASN.1) オブジェクトがある場合は、このメソッドを使用できます。 DER でエンコードされたオブジェクトは、Unicode でエンコードされた文字列に指定する必要があります。 詳細については、 IBinaryConverter インターフェイスを参照してください。

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

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

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

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

関連項目

IX509ExtensionBasicConstraints