IX509EnrollmentHelper::Enroll メソッド (certenroll.h)

  • [アーティクル]

Enroll メソッドは、証明書要求を登録し、発行された証明書を取得します。 このメソッドは Web 対応です。

構文

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

パラメーター

[in] strEnrollmentPolicyServerURI

証明書登録ポリシー サーバー URL を含む BSTR 。

[in] strTemplateName

Active Directory またはドット 10 進オブジェクト識別子に表示されるテンプレートの共通名 (CN) を含む BSTR 変数。

[in] Encoding

表示目的でバイト配列に適用されるエンコードの種類を指定する EncodingType 列挙値。

[in] enrollFlags

Web 登録の動作を指定する WebEnrollmentFlags 列挙値。 次の値を指定できます。

値 意味
EnrollPrompt
 このフラグが設定されていて、証明書登録サーバーで認証資格情報を使用できない場合、証明書サービスは資格情報の入力を求めます。 認証資格情報がなく、このフラグが設定されていない場合、 Enroll メソッドは失敗します。

[out, retval] pstrCertificate

発行された証明書を含む BSTR 。

戻り値

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

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

リターン コード 説明
E_INVALIDARG
 strEnrollmentPolicyServerURI パラメーターと strTemplateName パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)
 strEnrollmentPolicyServerURI パラメーターと strTemplateName パラメーターが 64,000 文字を超えるか、埋め込み null 文字が含まれています。

注釈

Enroll メソッドは、適切なテンプレートを取得し、InitializeFromTemplate を呼び出してから、IX509Enrollment オブジェクトで Enroll を呼び出します。

この方法では、発行された証明書はインストールされません。

要件

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

こちらもご覧ください

IX509EnrollmentHelper