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

  • [アーティクル]

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

構文

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

パラメーター

[in] propertyId

取得するプロパティ値を指定する CESSetupProperty 列挙値。 詳細については、「解説」を参照してください。

[out] pPropertyValue

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

戻り値

リターン コード 説明
E_INVALIDARG
 propertyId 引数は、CESSetupProperty 列挙型のメンバーではありません。
E_POINTER
 pPropertyValue パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 ICertificateEnrollmentServerSetup オブジェクトが初期化されていません。

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

注釈

CESSetupProperty 列挙型には、次の値が含まれています。

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

これらの値には次の意味があります。

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY プロパティは、サーバー コンテキストが ApplicationPoolIdentity かどうかを指定するVT_BOOL値です。
  • ENUM_CESSETUPPROP_CACONFIG プロパティには、computerDNSnameCAName フォームの証明機関 (CA) 構成文字列 (VT_BSTR) が含まれます。computerDNSname/ はサーバーの完全修飾 DNS 名、CAName は CA の共通名です。
  • ENUM_CESSETUPPROP_AUTHENTICATION プロパティは、使用する認証手順の種類を指定します。 GetProperty メソッドが正常に返された場合、pPropertyValue 引数には次のいずれかの定数が含まれます。
    • X509AuthKerberos
    • X509AuthUsername
    • X509AuthCertificate
  • ENUM_CESSETUPPROP_SSLCERTHASH プロパティには、認証時に使用される証明書のハッシュ (VT_BSTR) が含まれています。 ENUM_CESSETUPPROP_AUTHENTICATION プロパティは X509AuthCertificate に設定する必要があります。
  • ENUM_CESSETUPPROP_URL プロパティには、CES サービス URL が含まれています。 GetProperty メソッドが正常に返された場合、pPropertyValue 引数には、"https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces" という形式の URL を含むVT_BSTRサブタイプが含まれます。ここで、認証の種類は次のいずれかになります。
    • Kerberos
    • usernamepassword
    • 証明書 (certificate)
  • ENUM_CESSETUPPROP_RENEWALONLY プロパティは、CES が証明書の更新のみを処理できるかどうかを指定するVT_BOOL値です。

要件

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

こちらもご覧ください

ICertificateEnrollmentServerSetup