ICertSrvSetup::CAImportPFX 메서드(casetup.h)

CAImportPFX 메서드는 CA(인증 기관) 인증서와 연결된 프라이빗 키를 로컬 컴퓨터 저장소로 가져옵니다. 이 메서드는 CCertSrvSetup 개체의 상태를 변경하지 않습니다.

구문

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

매개 변수

[in] bstrFileName

프라이빗 키를 가져오는 데 사용되는 PFX 파일의 이름을 포함하는 문자열입니다.

[in] bstrPasswd

PFX 파일의 암호를 포함하는 문자열입니다.

[in] bOverwriteExistingKey

동일한 이름의 기존 키를 덮어쓸지 여부를 나타내는 값입니다.

[out] ppVal

가져온 프라이빗 키의 속성을 설정하는 데 사용할 수 있는 ICertSrvSetupKeyInformation 인터페이스에 대한 포인터의 주소입니다.

반환 값

없음

설명

CAImportPFX 메서드는 입력 매개 변수를 사용하여 PFX 파일의 암호를 해독하고 디코딩한 다음 로컬 컴퓨터 저장소에 키와 인증서를 설치합니다. 인증서가 다음 조건을 충족하고 키를 설치한 후 메서드가 ICertSrvSetupKeyInformation 개체를 호출자에게 반환합니다.

• 프라이빗 키 컨테이너의 키와 일치하는 AT_SIGNATURE 키를 포함합니다.
• 자체 서명되었거나 CA에 대한 기본 제약 조건이 있습니다.
• 체인 유효성 검사를 통과하지만 오프라인 해지 오류가 발생할 수 있습니다.

PFX 파일에 여러 인증서와 키가 포함된 경우 CAImportPFX 는 모든 인증서와 키를 설치합니다. 그러나 반환된 ICertSrvSetupKeyInformation 개체에는 파일의 마지막 CA 인증서 속성만 포함됩니다. 호출자가 ICertSrvSetupKeyInformation 개체를 사용하여 완료되면 호출자는 Release 메서드를 사용하여 해제해야 합니다.

요구 사항

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

추가 정보

ICertSrvSetup