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

  • [アーティクル]

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

構文

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

パラメーター

[in] propertyId

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

値 説明
ENUM_CEPSETUPPROP_AUTHENTICATION pPropertyValue パラメーターには、使用する認証の種類を識別する値が含まれています。
ENUM_CEPSETUPPROP_SSLCERTHASH pPropertyValue パラメーターには、認証時に使用される証明書のハッシュ (存在する場合) が含まれます。
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL pPropertyValue パラメーターは、KeyBasedRenewal テンプレートのみのポリシーを返すモードで登録ポリシー サーバーを設定するかどうかを指定します。
ENUM_CEPSETUPPROP_URL CEP サービス URL が含まれます。 GetProperty メソッドが正常に返された場合、pPropertyValue 引数には、"https:// computerDNSname/ADPolicyProvider_cep_AuthenticationType/service.svc/cep" という形式の URL を含むVT_BSTR サブタイプが含まれます。ここで、認証の種類は次のいずれかになります。
  • Kerberos
  • usernamepassword
  • 証明書 (certificate)

[out] pPropertyValue

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

propertyId パラメーターでENUM_CEPSETUPPROP_AUTHENTICATIONを指定した場合、GetProperty メソッドが正常に返された場合、pPropertyValue パラメーターには次のいずれかの定数が含まれます。

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

propertyId パラメーターでENUM_CEPSETUPPROP_SSLCERTHASHを指定した場合、GetProperty メソッドが正常に返された場合、pPropertyValue パラメーターにはハッシュを含むVT_BSTRサブタイプが含まれます。

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 列挙型のメンバーではありません。
E_POINTER
 pPropertyValue パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 ICertificateEnrollmentPolicyServerSetup オブジェクトが初期化されていません。

ErrorString プロパティの値が "セットアップ オブジェクトが初期化されていません。 InitializeInstallDefaults メソッドを使用してセットアップ オブジェクトを初期化してください。

要件

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

こちらもご覧ください

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty