PFXExportCertStore 함수(wincrypt.h)

  • 아티클

PFXExportCertStore 함수는 인증서를 내보내고, 사용 가능한 경우 참조된 인증서 저장소에서 연결된 프라이빗 키를 내보냅니다. 인터넷 Explorer 4.0 클라이언트와의 호환성을 위해 유지되는 이전 함수입니다. 새 애플리케이션은 향상된 프라이빗 키 보안을 제공하는 PfxExportCertStoreEx 함수를 사용해야 합니다.

구문

BOOL PFXExportCertStore(
  [in]      HCERTSTORE      hStore,
  [in, out] CRYPT_DATA_BLOB *pPFX,
  [in]      LPCWSTR         szPassword,
  [in]      DWORD           dwFlags
);

매개 변수

[in] hStore

내보낼 인증서를 포함하는 인증서 저장소의 핸들입니다.

[in, out] pPFX

내보낸 인증서 및 키가 있는 PFX 패킷을 포함하는 CRYPT_DATA_BLOB 구조체에 대한 포인터입니다. pPFX-pbData> 가 NULL인 경우 함수는 인코딩된 BLOB에 필요한 바이트 수를 계산하고 이를 pPFX-cbData>로 반환합니다. 필요한 크기의 할당된 버퍼를 가리키는 pPFX-pbData> 를 사용하여 함수를 호출하면 함수는 인코딩된 바이트를 버퍼에 복사하고 인코딩 바이트 길이로 pPFX-cbData>를 업데이트합니다.

[in] szPassword

PFX 패킷을 암호화하고 확인하는 데 사용되는 문자열 암호입니다. 암호 사용을 마쳤으면 SecureZeroMemory 함수를 호출하여 메모리에서 암호를 지웁 수 있습니다. 암호 보호에 대한 자세한 내용은 암호 처리를 참조하세요.

[in] dwFlags

플래그 값은 다음의 조합으로 설정할 수 있습니다.

값 의미
EXPORT_PRIVATE_KEYS
 프라이빗 키는 인증서뿐만 아니라 내보내집니다.
REPORT_NO_PRIVATE_KEY
 연결된 프라이빗 키가 없는 인증서가 발견되면 함수는 마지막 오류가 CRYPT_E_NOT_FOUND 또는 NTE_NO_KEY 설정된 FALSE 를 반환합니다.
REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY
 내보낼 수 없는 프라이빗 키가 있는 인증서가 발견되면 함수는 FALSE 를 반환하고 마지막 오류 집합을 NTE_BAD_KEY, NTE_BAD_KEY_STATE 또는 NTE_PERM 반환합니다.

반환 값

함수가 성공하면 TRUE (0이 아닌)를 반환하고, 함수가 실패하면 FALSE (0)를 반환합니다. 확장 오류 정보는 GetLastError를 호출합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Crypt32.lib
DLL Crypt32.dll

추가 정보

PFXExportCertStoreEx

PFXImportCertStore