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

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

構文

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

パラメーター

[in] Encoding

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

[in] strEncodedData

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

戻り値

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

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

注釈

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

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

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

• Critical プロパティは、拡張機能が重要であるかどうかを識別します。 このプロパティを指定することもできます。
• ObjectId プロパティは、拡張オブジェクト識別子 (OID) を取得します。
• KeyUsage プロパティは、公開キー (生の拡張データ) の使用目的を識別する制限を取得します。

Requirements

こちらも参照ください

IX509ExtensionKeyUsage