KSP(Key Storage Provider)를 사용하는 NCryptExportKey
NCryptExportKey 함수는 KSP 키를 메모리 BLOB로 내보냅니다. 이 함수는 퍼블릭 키 내보내기만 지원합니다.
파라미터
-
hKey[in] -
내보낼 키의 핸들입니다.
-
hExportKey[in, 미사용] -
AWS CloudHSM KSP(Key Storage Provider)는 이 파라미터를 사용하지 않습니다.
pszBlobType[in]-
내보낼 BLOB 유형을 지정하는 Null로 종료된 유니코드 문자열입니다. AWS CloudHSM KSP(Key Storage Provider)는 다음 값을 지원합니다.
값 의미 BCRYPT_RSAPUBLIC_BLOB
RSA 퍼블릭 키를 내보냅니다.
pbOutput버퍼에는BCRYPT_RSAKEY_BLOB구조와 키 데이터가 포함됩니다.BCRYPT_ECCPUBLIC_BLOB
ECC 퍼블릭 키를 내보냅니다.
pbOutput버퍼에는BCRYPT_ECCKEY_BLOB구조와 키 데이터가 포함됩니다. pParameterList[in, 미사용]-
AWS CloudHSM KSP(Key Storage Provider)는 이 파라미터를 사용하지 않습니다.
pbOutput[out, 선택 사항]-
키 BLOB를 저장할 버퍼 주소입니다.
cbOutput를 사용하여 버퍼 크기를 지정합니다. NULL로 설정하면 함수는pcbResult가 가리키는 DWORD에 필요한 크기(바이트)를 저장합니다. cbOutput[in]-
바이트 단위의
pbOutput버퍼 크기입니다. pcbResult[out]-
pbOutput버퍼에 복사된 바이트 수를 저장하는 DWORD 변수 주소입니다.pbOutput가 NULL이면 함수는 필요한 버퍼 크기를 바이트 단위로 저장합니다. dwFlags[in]-
함수의 작동 방식을 수정하는 플래그입니다. 0 또는 다음을 사용할 수 있습니다.
값 의미 NCRYPT_SILENT_FLAG
이 플래그는 효과가 없습니다.
반환 값
이 함수는 성공 또는 실패를 나타내는 상태 코드를 반환합니다.
일반적인 반환 코드는 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
ERROR_SUCCESS |
작업이 성공적으로 완료되었습니다. |
|
NTE_INVALID_PARAMETER |
하나 이상의 파라미터가 유효하지 않습니다. |
|
NTE_FAIL |
작업을 완료할 수 없습니다. |
|
NTE_INVALID_HANDLE |
|
|
NTE_BAD_FLAGS |
|
|
NTE_BAD_KEY_STATE |
키 상태가 유효하지 않습니다. |
|
NTE_NOT_SUPPORTED |
|
|
STATUS_INTERNAL_ERROR |
작업 중에 내부 오류가 발생했습니다. |
