次の方法で共有

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

  • [アーティクル]

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

構文

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

パラメーター

[in] propertyId

設定するプロパティ値を指定する CEPSetupProperty 列挙の値。 次の値が有効です。

値 説明
ENUM_CEPSETUPPROP_AUTHENTICATION pPropertyValue パラメーターには、使用する認証の種類を識別する値が含まれています。
ENUM_CEPSETUPPROP_SSLCERTHASH pPropertyValue パラメーターには、認証時に使用される証明書のハッシュ (存在する場合) が含まれます。 ENUM_CEPSETUPPROP_AUTHENTICATION は X509AuthCertificate に設定する必要があります。
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL pPropertyValue パラメーターは、KeyBasedRenewal テンプレートのみのポリシーを返すモードで登録ポリシー サーバーを設定するかどうかを指定します。
ENUM_CEPSETUPPROP_URL この値は指定できません。

[in] pPropertyValue

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

propertyId パラメーターにENUM_CEPSETUPPROP_AUTHENTICATIONを指定する場合、VARIANT サブタイプはVT_I2、VT_I4、またはVT_UII4である必要があり、pPropertyValue 引数は次のいずれかの定数である必要があります。

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

propertyId パラメーターでENUM_CEPSETUPPROP_SSLCERTHASHを指定する場合は、認証に使用される証明書のハッシュを含むVT_BSTR サブタイプに pPropertyValue パラメーターを設定する必要があります。

propertyId パラメーターにENUM_CEPSETUPPROP_AUTHENTICATIONを指定した場合、pPropertyValue パラメーターには認証手順が含まれます。

propertyId パラメーターでENUM_CEPSETUPPROP_URLを指定した場合、pPropertyValue パラメーターには証明書登録ポリシー (CEP) Web サービス URL が含まれます。

propertyId パラメーターでENUM_CEPSETUPPROP_KEYBASED_RENEWALを指定する場合は、pPropertyValue パラメーターを、KeyBasedRenewal テンプレートのみのポリシーを返すモードで登録ポリシー サーバーを設定するかどうかを示すVT_BOOL サブタイプに設定する必要があります。

戻り値

リターン コード 説明
E_INVALIDARG
 propertyId 引数が CEPSetupProperty 列挙型のメンバーではないか、ENUM_CEPSETUPPROP_URL値を設定しようとしました。
E_POINTER
 pPropertyValue パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 ICertificateEnrollmentPolicyServerSetup オブジェクトが初期化されていません。

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

解説

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

要件

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

関連項目

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults