IX509ExtensionTemplate::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 値」を参照してください。
リターン コード/値 | Description |
---|---|
|
オブジェクトは既に初期化されています。 |
注釈
CertificateTemplate 拡張機能を含む Distinguished Encoding Rules (DER) でエンコードされた Abstract Syntax Notation One (ASN.1) オブジェクトがある場合は、このメソッドを使用できます。 DER でエンコードされたオブジェクトは、Unicode でエンコードされた文字列で指定する必要があります。 詳細については、 IBinaryConverter インターフェイスを参照してください。
IX509ExtensionTemplate オブジェクトを使用するには、InitializeEncode または InitializeDecode を呼び出す必要があります。 2 つのメソッドは相互に補完し合います。 InitializeEncode メソッドを使用すると、生データから DER でエンコードされた ASN.1 拡張オブジェクトを構築できます。InitializeDecode メソッドを使用すると、エンコードされたオブジェクトから生データを初期化できます。
この拡張機能の次のプロパティを取得できます。
- Critical プロパティは、拡張機能が重要かどうかを識別します。 このプロパティを指定することもできます。
- ObjectId プロパティは、オブジェクト識別子 (OID) を取得します。
- MajorVersion プロパティと MinorVersion プロパティは、バージョン情報を取得します。
- TemplateOid プロパティは、テンプレートの OID を取得します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | certenroll.h |
[DLL] | CertEnroll.dll |