다음을 통해 공유

ICertificateEnrollmentServerSetup::GetProperty 메서드(casetup.h)

  • 아티클

GetProperty 메서드는 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 속성에는 컴퓨터DNSname CAName/ 형식의 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