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

  • [アーティクル]

Initialize メソッドは IX509EnrollmentPolicyServer オブジェクトを初期化します。

構文

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

パラメーター

[in] bstrPolicyServerUrl

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

[in] bstrPolicyServerId

証明書登録ポリシー サーバーの一意の ID を含む BSTR 変数。 この値が NULL でない場合は、CEP 応答によって返される ID 文字列と一致する必要があります。

[in] authFlags

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

値 意味
X509AuthAnonymous
 匿名認証。
X509AuthKerberos
 Kerberos 認証。
X509AuthUsername
 テキスト ユーザー名とパスワード認証をクリアします。
メモ ユーザー名とパスワードは転送前に暗号化され、CEP サーバーの資格情報コンテナーに安全に格納されます。
 
X509AuthCertificate
 ローカル コンピューターにインストールされ、サーバーがクライアントの ID を確認するために使用するクライアント認証証明書。

[in] fIsUnTrusted

信頼されていない証明機関の証明書を許可するかどうかを指定するブール値。

[in] context

証明書の登録を目的とするエンド エンティティの性質を指定する X509CertificateEnrollmentContext 列挙値。 これには、次のいずれかの値を指定できます。

値 意味
ContextUser
 証明書はエンド ユーザーを対象としています。
ContextMachine
 証明書はコンピューターを対象としています。
ContextAdministratorForceMachine
 証明書は、コンピューターの代わりに機能する管理者によって要求されています。

戻り値

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

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

リターン コード 説明
E_INVALIDARG
 bstrPolicyServerUrl パラメーターは空の文字列にすることはできません。HTTPS URL を表す必要があります。
E_OUTOFMEMORY
 bstrPolicyServerUrl パラメーターまたは bstrPolicyServerId パラメーターで指定された文字列に十分なメモリが使用できませんでした。
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 IX509EnrollmentPolicyServer オブジェクトは既に初期化されています。
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 bstrPolicyServerId パラメーターで指定された値は NULL ではなく、CEP サーバー上の既存の CEP ID 値と等しくありません。

要件

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

こちらもご覧ください

IX509EnrollmentPolicyServer