IX509EnrollmentPolicyServer::SetCredential メソッド (certenroll.h)

  • [アーティクル]

SetCredential メソッドは、証明書登録ポリシー (CEP) サーバーへの接続に使用する資格情報を設定します。

構文

HRESULT SetCredential(
  [in] LONG                    hWndParent,
  [in] X509EnrollmentAuthFlags flag,
  [in] BSTR                    strCredential,
  [in] BSTR                    strPassword
);

パラメーター

[in] hWndParent

親ウィンドウ ハンドル。

[in] flag

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

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

[in] strCredential

資格情報を含む BSTR 変数。

[in] strPassword

パスワードを含む BSTR 変数。

戻り値

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

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

リターン コード 説明
E_INVALIDARG
 フラグ パラメーターはサポートされている値ではありません。

注釈

strCredential 引数と strPassword 引数は、次の表に示すように、flag 引数で指定された値に応じて変更されます。

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

こちらもご覧ください

IX509EnrollmentPolicyServer