次の方法で共有


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

InitializeEncode メソッドは、文字列と修飾子の型を識別する値からオブジェクトを初期化します。

構文

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

パラメーター

[in] strQualifier

修飾子を含む BSTR 変数。

[in] Type

証明書ポリシーに適用される修飾子の種類を指定する PolicyQualifierType 列挙値。 次のいずれかの値を指定できます。

価値 Meaning
PolicyQualifierTypeUnknown
修飾子の型が指定されていません。
PolicyQualifierTypeUrl
修飾子は、証明書が発行されたポリシーと証明書を使用できる目的の概要を示すために証明機関によって定義されている認定プラクティス ステートメント (CPS) を指す URL です。
PolicyQualifierTypeUserNotice
修飾子は、証明書に依存するすべてのユーザーにアプリケーションによって表示されるテキスト ステートメントです。 ユーザー通知は、証明書の許可された使用を識別します。

戻り値

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

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

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

注釈

Type パラメーターに PolicyQualifierTypeUrl を指定した場合、このメソッドは strQualifier パラメーターに入力された文字列をXCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) オブジェクト識別子 (OID) に関連付け、識別エンコード 規則 (DER) を使用してエンコードします。 URL は 、抽象構文表記 1 (ASN.1) IA5 文字列としてエンコードされます。

Type パラメーターに PolicyQualifierTypeUserNotice を指定した場合、このメソッドは strQualifier パラメーターに入力された文字列を XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) OID に関連付け、DER を使用してエンコードします。

このオブジェクトの次のプロパティを取得できます。

  • ObjectId プロパティは、修飾子が CPS かユーザー通知かを識別する OID を取得します。
  • Qualifier プロパティは、InitializeEncode メソッドの strQualifier パラメーターに指定された文字列を取得します。
  • RawData プロパティは、DER でエンコードされた修飾子を取得します。
  • Type プロパティは、修飾子の種類を指定する PolicyQualifierType 列挙の値を取得します。

Requirements

Requirement 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム ウィンドウズ
Header certenroll.h
DLL CertEnroll.dll

こちらも参照ください

IPolicyQualifier