ICertSrvSetup::SetCADistinguishedName 메서드(casetup.h)
SetCADistinguishedName 메서드는 CA(인증 기관) 일반 이름과 선택적 고유 이름 접미사를 설정합니다.
구문
HRESULT SetCADistinguishedName(
[in] const BSTR bstrCADN,
[in] VARIANT_BOOL bIgnoreUnicode,
[in] VARIANT_BOOL bOverwriteExistingKey,
[in] VARIANT_BOOL bOverwriteExistingCAInDS
);
매개 변수
[in] bstrCADN
CommonName, DistinguishedNameSuffix 형식의 CA 이름을 포함하는 문자열입니다. 여기서 쉼표(,) 및 DistinguishedNameSuffix는 선택 사항입니다.
다음 표에서는 컴퓨터 MyServer에 대한 선택적 고유 이름 접미사를 포함하여 고유 이름의 예를 설명합니다.
값 | 의미 |
---|---|
|
MyDomain 도메인에 속하는 MyServer 컴퓨터의 일반 이름입니다. |
|
고유 이름 접미사(선택 사항) |
|
선택적 접미사를 포함한 고유 이름 |
[in] bIgnoreUnicode
이름 정보의 유니코드 인코딩을 허용할지 여부를 나타내는 값입니다. VARIANT_TRUE 값을 사용하면 유니코드 인코딩을 사용할 수 있습니다.
[in] bOverwriteExistingKey
컴퓨터에 이름이 같은 프라이빗 키가 있더라도 bstrCADN에서 이름을 허용할지 여부를 나타내는 값입니다. VARIANT_TRUE 값을 사용하면 메서드가 기존 키를 덮어쓸 수 있습니다.
[in] bOverwriteExistingCAInDS
이름이 동일한 CA가 디렉터리 서비스에 있더라도 bstrCADN에서 이름을 허용할지 여부를 나타내는 값입니다. VARIANT_TRUE 값을 사용하면 메서드가 기존 디렉터리 서비스 항목을 덮어쓸 수 있습니다.
반환 값
없음
설명
성공하면 SetCADistinguishedName 메서드는 ENUM_SETUPPROP_CANAME 변경하고 bstrCADN 이름을 반영하도록 속성 값을 ENUM_SETUPPROP_CADSSUFFIX. 설정 속성에 대한 자세한 내용은 CASetupProperty를 참조하세요.
오류가 발생하면 SetCADistinguishedName 메서드가 CAErrorId 및 CAErrorString 속성 에 추가 오류 정보를 설정할 수 있습니다.
기존 키와 연결된 인증서를 사용하여 CA를 구성하는 경우 이 메서드를 호출해서는 안 됩니다. 연결된 인증서를 사용하지 않고 기존 키를 사용하여 CA를 구성하는 경우 bstrCADN 의 일반 이름은 키의 삭제된ContainerName 과 일치해야 합니다.
bstrCADN에 UTF8 인코딩이 포함된 경우 CAPolicy.inf에서 적절한 플래그를 설정하고 %windir%에 배치합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | casetup.h |
DLL | Certocm.dll |