다음을 통해 공유

ICertAdmin2::SetCAProperty 메서드(certadm.h)

  • 아티클

SetCAProperty 메서드는 CA(인증 기관)의 속성 값을 설정합니다.

통사론

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

매개 변수

[in] strConfig

COMPUTERNAME은 인증서 서비스 서버의 네트워크 이름이고 CANAME는 인증서 서비스 설정 중에 입력한 대로 CA의 일반 이름인 COMPUTERNAME\CANAME 형식의 CA에 대한 유효한 구성 문자열을 나타내는 문자열 값입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig참조하세요.

중요SetCAProperty 구성 문자열이 변경될 때 내부 캐시를 지우지 않습니다. CA에 대한 구성 문자열을 변경하는 경우 새 ICertAdmin 개체를 인스턴스화하고 새 구성 문자열을 사용하여 이 메서드를 다시 호출해야 합니다.

 

[in] PropId

다음 속성 식별자 중 하나를 지정합니다.

읽기 전용인 속성을 포함하여 모든 CA 속성에 대한 자세한 내용은 ICertAdmin2::GetCAProperty참조하세요.

값 의미
CR_PROP_KRACERT
 CA의 KRA(키 복구 에이전트) 인증서입니다.

데이터 형식: 이진, 인덱싱됨
CR_PROP_KRACERTCOUNT
 CA에 대한 KRA 인증서 수입니다.

데이터 형식: Long.
CR_PROP_KRACERTUSEDCOUNT
 CA에서 사용하는 KRA 인증서 수입니다.

데이터 형식: Long.
CR_PROP_ROLESEPARATIONENABLED
 역할 분리를 사용할지 여부를 지정하는 값입니다.

데이터 형식: Long.
CR_PROP_TEMPLATES
 CA에서 지원하는 템플릿 목록입니다.

데이터 형식: 문자열.

[in] PropIndex

PropId 매개 변수가 인덱싱되면 속성 값을 검색할 때 사용할 인덱스(0부터 시작하는 인덱스)입니다. PropId 인덱싱되지 않으면 이 값은 무시됩니다.

[in] PropType

속성의 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
PROPTYPE_LONG
 서명된 긴 데이터입니다.
PROPTYPE_DATE
 날짜/시간(나중에 사용하기 위해 예약됨).
PROPTYPE_BINARY
 이진 데이터입니다.
PROPTYPE_STRING
 유니코드문자열 데이터를 .

[in] pvarPropertyValue

C++ 속성 값을 지정하는 VARIANT 대한 포인터입니다.
VB 속성 값을 지정하는 Variant.

반환 값

VB

함수가 성공하면 반환 값이 S_OK.

함수가 실패하면 반환 값은 오류를 나타내는 HRESULT. 일반적인 오류 코드 목록은공통 HRESULT 값 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 지원되지 않는 항목
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certadm.h(Certsrv.h 포함)
라이브러리 Certidl.lib
DLL Certadm.dll

참고 항목

ICertAdmin2

ICertAdmin2::GetCAProperty