다음을 통해 공유

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

  • 아티클

GetProperty 메서드는 CEP(인증서 등록 정책) 웹 서비스 구성에 대한 CEPSetupProperty 열거형 값을 검색합니다.

구문

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

매개 변수

[in] propertyId

설정할 속성 값을 지정하는 CEPSetupProperty 열거형의 값입니다. 다음 값이 유효합니다.

값 Description
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(인증서 등록 정책) 웹 서비스 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