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

  • [アーティクル]

AddEnrollmentServer メソッドは、証明書登録サーバー (CES) アクセス資格情報を資格情報キャッシュに保存します。 このメソッドは Web 対応です。

構文

HRESULT AddEnrollmentServer(
  [in] BSTR                    strEnrollmentServerURI,
  [in] X509EnrollmentAuthFlags authFlags,
  [in] BSTR                    strCredential,
  [in] BSTR                    strPassword
);

パラメーター

[in] strEnrollmentServerURI

証明書登録サーバーの URL を含む BSTR 。

[in] authFlags

クライアント認証の種類を指定する X509EnrollmentAuthFlags 列挙値。 これには、次のいずれかの値を指定できます。

値 意味
X509AuthAnonymous
 匿名認証。 strCredential パラメーターと strPassword パラメーターを NULL に設定します。
X509AuthKerberos
 Kerberos 認証。 strCredential パラメーターと strPassword パラメーターを NULL に設定します。
X509AuthUsername
 テキスト ユーザー名とパスワード認証をクリアします。 strCredential パラメーターと strPassword パラメーターを、ユーザー名と関連付けられたパスワードに設定します。 これらの文字列は送信前に暗号化され、証明書登録サーバーの資格情報コンテナーに安全に格納されます。
X509AuthCertificate
 ローカル コンピューターにインストールされ、サーバーがクライアントの ID を確認するために使用するクライアント認証証明書。 strPassword パラメーターを NULL に設定し、証明書の 20 バイト SHA1 ハッシュである証明書拇印を strCredential パラメーターに設定します。

[in] strCredential

資格情報を含む BSTR 。

[in] strPassword

クリア テキスト パスワードを含む BSTR 。

戻り値

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

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

リターン コード 説明
E_INVALIDARG
 strEnrollmentServerURI パラメーターを NULL または空にすることはできません。

X509AuthAnonymous または X509AuthKerberos が authFlags パラメーターで指定されている場合、 strCredential パラメーターを NULL にすることはできません。

authFlags パラメーターに X509AuthCertificate が指定されている場合、strCredential パラメーターは NULL である必要があります。

authFlags パラメーターで X509AuthCertificateis が指定されている場合、strPassword パラメーターは NULL である必要がありますが、strCredential パラメーターは指定できません。
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)
 strPassword、strCredential、または strEnrollmentServerURI パラメーターが 64,000 文字を超えるか、null 文字が埋め込まれています。

解説

strCredential 引数と strPassword 引数は、次の表に示すように、authFlags 引数で指定された値によって変わります。

flag パラメーター strCredential パラメーター strPassword パラメーター
X509AuthAnonymous NULL NULL
X509AuthKerberos NULL NULL
X509AuthUsername CEP サーバーによって認識されるテキスト ユーザー名をクリアします。 ユーザー名に関連付けられているテキスト パスワードをクリアします。
X509AuthCertificate 証明書の 20 バイト SHA-1 ハッシュ (拇印) が含まれています。 NULL

要件

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

関連項目

IX509EnrollmentHelper