ICertificateEnrollmentPolicyServerSetup::SetProperty 메서드(casetup.h)
SetProperty 메서드는 CEP(인증서 등록 정책) 웹 서비스 구성에 대한 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 지정하는 경우 pPropertyValue 매개 변수를 인증에 사용되는 인증서의 해시를 포함하는 VT_BSTR 하위 형식으로 설정해야 합니다.
propertyId 매개 변수에서 ENUM_CEPSETUPPROP_AUTHENTICATION 지정하면 pPropertyValue 매개 변수에 인증 절차가 포함됩니다.
propertyId 매개 변수에서 ENUM_CEPSETUPPROP_URL 지정하는 경우 pPropertyValue 매개 변수에는 CEP(인증서 등록 정책) 웹 서비스 URL이 포함됩니다.
propertyId 매개 변수에서 ENUM_CEPSETUPPROP_KEYBASED_RENEWAL 지정하는 경우 pPropertyValue 매개 변수를 keyBasedRenewal 템플릿에 대한 정책만 반환하는 모드에서 등록 정책 서버를 설정할지 여부를 나타내는 VT_BOOL 하위 형식으로 설정해야 합니다.
반환 값
| 반환 코드 | 설명 |
|---|---|
|
propertyId 인수는 CEPSetupProperty 열거형 형식의 멤버가 아니거나 ENUM_CEPSETUPPROP_URL 값을 설정하려고 했습니다. |
|
pPropertyValue 매개 변수는 NULL일 수 없습니다. |
|
ICertificateEnrollmentPolicyServerSetup 개체가 초기화되지 않았습니다.
ErrorString 속성 값은 "설정 개체가 초기화되지 않았습니다. InitializeInstallDefaults 메서드를 사용하여 설치 개체를 초기화하세요." |
|
ENUM_CEPSETUPPROP_AUTHENTICATION 속성을 설정하는 경우 VARIANT 하위 형식은 VT_I2, VT_I4 또는 VT_UI4 합니다. |
설명
SetProperty 메서드를 호출하기 전에 InitializeInstallDefaults를 호출해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | casetup.h |
| DLL | Certocm.dll |