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에 대한 선택적 고유 이름 접미사를 포함하여 고유 이름의 예를 설명합니다.

값	의미
CN=mydomain-MyServer-CA	MyDomain 도메인에 속하는 MyServer 컴퓨터의 일반 이름입니다.
DC=MyDomain,DC=MyCompany,DC=com	고유 이름 접미사(선택 사항)
CN=MyDomain-MyServer-CA,DC=MyDomain,DC=MyCompany,DC=com	선택적 접미사를 포함한 고유 이름

[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

추가 정보

ICertSrvSetup