ICertificateEnrollmentServerSetup::SetProperty メソッド (casetup.h)

  • [アーティクル]

SetProperty メソッドは、証明書登録 Web サービス (CES) 構成の CESSetupProperty 列挙値を指定します。

構文

HRESULT SetProperty(
  [in] CESSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

パラメーター

[in] propertyId

取得するプロパティ値を指定する CESSetupProperty 列挙値。

[in] pPropertyValue

プロパティ値を含む VARIANT 変数へのポインター。

戻り値

リターン コード 説明
E_INVALIDARG
 propertyId 引数は、CESSetupProperty 列挙型のメンバーではありません。

また、 ENUM_CESSETUPPROP_AUTHENTICATION プロパティを設定する場合は、 pPropertyValue 引数に次のいずれかの値を指定する必要があります。

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
E_POINTER
 pPropertyValue パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 ICertificateEnrollmentServerSetup オブジェクトが初期化されていません。

ErrorString プロパティの値が "セットアップ オブジェクトが初期化されていません。 InitializeInstallDefaults メソッドを使用してセットアップ オブジェクトを初期化してください。
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 ENUM_CESSETUPPROP_AUTHENTICATION プロパティを設定する場合、VARIANT サブタイプはVT_I2、VT_I4、またはVT_UI4である必要があります。

注釈

SetProperty を呼び出す前に InitializeInstallDefaults を呼び出す必要があります。

ENUM_CESSETUPPROP_URL プロパティを設定することはできません。

WSEnrollmentServer アプリケーション プールが既に存在し、WMI が初期化されている場合、 ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY を設定することはできません。

ENUM_CESSETUPPROP_AUTHENTICATION プロパティを設定する場合、VARIANT サブタイプはVT_I2、VT_I4、またはVT_UII4である必要があり、pPropertyValue 引数は次のいずれかの定数である必要があります。

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

ターゲット サーバーがスタンドアロン証明機関である場合、ENUM_CESSETUPPROP_CACONFIG プロパティを設定することはできません。 ErrorString プロパティは、"証明書登録 Web サービスはスタンドアロン証明機関 (CA) では使用できません。 エンタープライズ CA でのみ使用できます。

.

要件

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

こちらもご覧ください

ICertificateEnrollmentServerSetup