Share via

ICertificateEnrollmentServerSetup::InitializeInstallDefaults 메서드(casetup.h)

  • 아티클

InitializeInstallDefaults 메서드는 기본 구성을 사용하여 ICertificateEnrollmentServerSetup 개체를 초기화합니다.

구문

HRESULT InitializeInstallDefaults();

반환 값

반환 코드 Description
E_ACCESSDENIED
 사용자는 도메인 루트 또는 엔터프라이즈의 관리자여야 합니다. 컴퓨터를 도메인에 가입해야 합니다.

사용자가 도메인 루트 또는 엔터프라이즈 관리자가 아닌 경우 ErrorString 속성은 다음으로 설정됩니다.

"설치 프로그램을 실행하려면 Enterprise Admins 그룹의 구성원이어야 합니다."

컴퓨터가 도메인에 가입되지 않은 경우 ErrorString 속성은 다음으로 설정됩니다.

"인증서 등록 웹 서비스 또는 인증서 등록 정책 웹 서비스는 도메인의 구성원이 아닌 컴퓨터에 설치할 수 없습니다."
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 ICertificateEnrollmentServerSetup 개체가 이미 초기화되었습니다. ErrorString 속성은 다음으로 설정됩니다.

"설치 개체가 이미 초기화되었습니다. 이 개체는 두 번 이상 초기화할 수 없습니다."

설명

이 메서드는 다음 작업을 수행합니다.

  • ICertificateEnrollmentServerSetup 개체가 이미 초기화되었는지 여부를 확인합니다.
    참고 이 검사 실패하면 메서드는 ErrorString 속성을 "설치 개체가 이미 초기화되었습니다. 이 개체는 두 번 이상 초기화할 수 없습니다."
     
  • 사용자가 도메인 루트의 관리자인지 엔터프라이즈인지 확인합니다.
    참고 이 검사 실패하면 메서드는 ErrorString 속성을 "설치 프로그램을 실행하려면 Enterprise Admins 그룹의 구성원이어야 합니다."로 설정합니다.
     
  • 컴퓨터가 도메인에 가입되어 있는지 여부를 결정합니다.
    참고 이 검사 실패하면 메서드는 ErrorString 속성을 "도메인의 구성원이 아닌 컴퓨터에 인증서 등록 웹 서비스 또는 인증서 등록 정책 웹 서비스를 설치할 수 없습니다."로 설정합니다.
     
  • 기본 인증 절차를 Kerberos로 설정합니다. SetProperty를 호출하여 인증 방법을 변경할 수 있습니다.
  • WINDOWS Server 2008 R2를 실행하는 컴퓨터에 CES가 설치되어 있는지 여부를 확인합니다.
    참고 이 검사 실패하면 메서드는 ErrorString 속성을 "ADPrep /forestprep의 Windows Server 2008 R2 버전이 성공적으로 실행된 Active Directory 포리스트의 멤버 서버에 인증서 등록 웹 서비스 또는 인증서 등록 정책 웹 서비스를 설치해야 합니다."로 설정합니다.
     
  • 기본 서버 컨텍스트를 ApplicationPoolIdentity 기본 제공 계정으로 설정합니다.
  • ENUM_CESSETUPPROP_RENEWALONLY 속성을 FALSE로 설정합니다.
  • 유효한 CA(인증 기관) 구성이 있는 경우 ENUM_CESSETUPPROP_URL 속성을 "https:// 컴퓨터DNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces"로 설정합니다. 유효한 구성이 없으면 ENUM_CESSETUPPROP_URL 속성이 설정되지 않습니다. SanitizedCAShortName은 CA의 삭제된 짧은 이름입니다. 삭제된 이름에 대한 자세한 내용은 GetConfig를 참조하세요.
    참고 인증 기관이 독립 실행형 CA인 경우 ErrorString 속성은 "인증서 등록 웹 서비스를 독립 실행형 CA(인증 기관)와 함께 사용할 수 없습니다. 엔터프라이즈 CA에서만 사용할 수 있습니다."
     
UnInstall 이외의 메서드를 호출하기 전에 InitializeInstallDefaults 메서드를 호출해야 합니다. Install 메서드를 호출하여 구성된 서비스를 설치합니다. 새 ICertificateEnrollmentServerSetup 개체에서 UnInstall을 호출하여 서비스를 제거합니다.

요구 사항

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

추가 정보

CESSetupProperty

ICertificateEnrollmentServerSetup