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