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

InitializeEncode メソッドは、テンプレート オブジェクト識別子 (OID) とメジャー バージョン番号とマイナー バージョン番号から拡張機能を初期化します。 このメソッドは Web 対応です。

構文

HRESULT InitializeEncode(
  [in] IObjectId *pTemplateOid,
  [in] LONG      MajorVersion,
  [in] LONG      MinorVersion
);

パラメーター

[in] pTemplateOid

テンプレート OID を表す IObjectId インターフェイスへのポインター。

[in] MajorVersion

テンプレートのメジャー バージョン番号を含む LONG 変数。 既定値は 0 です。

[in] MinorVersion

テンプレートのマイナー バージョン番号を含む LONG 変数。 既定値は 0 です。

戻り値

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

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

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

解説

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

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

• Critical プロパティは、拡張機能が重要かどうかを識別します。 このプロパティを指定することもできます。
• ObjectId プロパティは OID を取得します。
• MajorVersion プロパティと MinorVersion プロパティは、バージョン情報を取得します。
• TemplateOid プロパティは、テンプレートの OID を取得します。

IX509ExtensionBasicConstraints オブジェクトを使用するには、InitializeEncode または InitializeDecode を呼び出す必要があります。 2 つのメソッドは相互に補完し合います。 InitializeEncode メソッドを使用すると、生データからエンコードされた ASN.1 構造体を構築できます。InitializeDecode メソッドを使用すると、エンコードされた ASN.1 構造体から生データを初期化できます。 拡張機能の生データを取得するには、 MajorVersion、 MinorVersion、 TemplateOid の各プロパティを呼び出します。

要件

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

関連項目

IX509ExtensionTemplate