Share via

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