ICertAdmin2::ImportKey 메서드(certadm.h)

ImportKey 메서드는 인증서 서비스 데이터베이스의 항목에 암호화된 키 집합을 추가합니다. 키 집합은 하나 이상의 KRA(키 복구 에이전트) 인증서로 암호화됩니다.

구문

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

매개 변수

[in] strConfig

COMPUTERNAME\CANAME 형식의 CA( 인증 기관 )에 대한 유효한 구성 문자열을 나타내는 문자열 값입니다. 여기서 COMPUTERNAME은 인증서 서비스 서버의 네트워크 이름이고 CANAME는 인증서 서비스 설정 중에 입력한 대로 CA의 일반 이름입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig를 참조하세요.

중요ImportKey 는 구성 문자열이 변경되면 내부 캐시를 지우지 않습니다. CA에 대한 구성 문자열을 변경하는 경우 새 ICertAdmin 개체를 인스턴스화하고 새 구성 문자열을 사용하여 이 메서드를 다시 호출해야 합니다.

 

[in] RequestId

Certificates Services 데이터베이스의 인증서 요청 ID를 나타내는 LONG 값입니다. 요청 ID 대신 일련 번호( strCertHash로 전달됨)를 사용하는 경우 이 값에 0을 사용합니다.

[in] strCertHash

인증서 해시를 나타내는 문자열 값입니다. strCertHash를 사용하려면 RequestId에 0 값을 지정해야 합니다.

[in] Flags

키의 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
CR_IN_BASE64HEADER	시작 또는 끝의 BASE64 형식입니다.
CR_IN_BASE64	시작 또는 끝이 없는 BASE64 형식입니다.
CR_IN_BINARY	이진 형식입니다.

 

또한 비트 OR 연산을 사용하여 다음 값을 형식 값과 결합할 수 있습니다.

값	의미
IKF_OVERWRITE	모든 기존 KRA 인코딩된 정보를 덮어씁니다.

[in] strKey

KRA 키 정보를 나타내는 문자열 값입니다.

반환 값

없음

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certadm.h(Certsrv.h 포함)
라이브러리	Certidl.lib
DLL	Certadm.dll

추가 정보

ICertAdmin2