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

InitializeEncode メソッドは、ICertificatePolicies コレクションからオブジェクトを初期化します。

構文

HRESULT InitializeEncode(
  [in] ICertificatePolicies *pValue
);

パラメーター

[in] pValue

ICertificatePolicies インターフェイスへのポインター。

戻り値

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

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

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

注釈

メソッドは、名前コレクションをXCN_OID_CERT_POLICIES (2.5.29.32) オブジェクト識別子 (OID) に関連付け、Distinguished Encoding Rules (DER) を使用してエンコードします。

IX509ExtensionCertificatePolicies オブジェクトを使用するには、InitializeEncode または InitializeDecode を呼び出す必要があります。 2 つのメソッドは相互に補完し合います。 InitializeEncode メソッドを使用すると、未加工データから DER でエンコードされた抽象構文表記 1 (ASN.1) 拡張オブジェクトを構築できます。InitializeDecode メソッドを使用すると、エンコードされたオブジェクトから生データを初期化できます。 Policies プロパティを呼び出すことで、ポリシーのコレクション (生データ) を取得できます。

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

  • Critical プロパティは、拡張機能が重要かどうかを識別します。 このプロパティを指定することもできます。
  • ObjectId プロパティは、拡張機能 OID を取得します。
  • Policies プロパティは、証明書ポリシー (生の拡張機能データ) のコレクションを取得します。

要件

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

こちらもご覧ください

IX509ExtensionCertificatePolicies