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 하위 형식으로 설정해야 합니다.

반환 값

반환 코드	설명
E_INVALIDARG	propertyId 인수는 CEPSetupProperty 열거형 형식의 멤버가 아니거나 ENUM_CEPSETUPPROP_URL 값을 설정하려고 했습니다.
E_POINTER	pPropertyValue 매개 변수는 NULL일 수 없습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	ICertificateEnrollmentPolicyServerSetup 개체가 초기화되지 않았습니다. ErrorString 속성 값은 "설정 개체가 초기화되지 않았습니다. InitializeInstallDefaults 메서드를 사용하여 설치 개체를 초기화하세요."
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)	ENUM_CEPSETUPPROP_AUTHENTICATION 속성을 설정하는 경우 VARIANT 하위 형식은 VT_I2, VT_I4 또는 VT_UI4 합니다.

설명

SetProperty 메서드를 호출하기 전에 InitializeInstallDefaults를 호출해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	casetup.h
DLL	Certocm.dll

추가 정보

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults