EnclaveUnsealData 함수(winenclaveapi.h)
암호화된 이진 큰 개체(Blob)의 암호를 해독합니다.
구문
HRESULT EnclaveUnsealData(
[in] const VOID *ProtectedBlob,
[in] UINT32 ProtectedBlobSize,
[out] PVOID DecryptedData,
[in] UINT32 BufferSize,
[out] UINT32 *DecryptedDataSize,
[out, optional] ENCLAVE_IDENTITY *SealingIdentity,
[out, optional] UINT32 *UnsealingFlags
);
매개 변수
[in] ProtectedBlob
봉인 해제할 봉인된 데이터에 대한 포인터입니다. 이 데이터는 enclave의 주소 범위 내에서 또는 호스트 프로세스의 주소 공간 내에 저장될 수 있습니다.
[in] ProtectedBlobSize
봉인 해제할 봉인된 데이터의 크기(바이트)입니다.
[out] DecryptedData
암호화되지 않은 데이터를 배치해야 하는 버퍼에 대한 포인터입니다. 이 데이터는 enclave의 주소 범위 내에서 또는 호스트 프로세스의 주소 공간 내에 저장될 수 있습니다. 이 매개 변수가 이 NULL면 암호 해독된 데이터의 크기만 계산됩니다.
[in] BufferSize
DecryptedData 매개 변수가 가리키는 버퍼의 크기(바이트)입니다. DecryptedData가 이면 BufferSize는 NULL0이어야 합니다. DecryptedData가 이 아니NULL고 암호 해독된 데이터의 크기가 이 값보다 크면 오류가 반환됩니다.
[out] DecryptedDataSize
암호 해독된 데이터의 실제 크기를 바이트 단위로 받는 변수에 대한 포인터입니다.
[out, optional] SealingIdentity
데이터를 봉인한 enclave의 ID로 채워야 하는 버퍼에 대한 선택적 포인터입니다. 이 포인터가 이 NULL면 봉인 enclave의 ID가 반환되지 않습니다.
[out, optional] UnsealingFlags
암호화된 이진 큰 개체를 설명하는 다음 플래그 중 0개 이상을 수신하는 변수에 대한 선택적 포인터입니다.
| 값 | 의미 |
|---|---|
ENCLAVE_UNSEAL_FLAG_STALE_KEY1 |
데이터가 부실 키로 암호화되었습니다. 봉인 키는 보안에 필요한 경우 회전되며 시스템은 최근에 알려진 고정된 수의 키만 유지할 수 있습니다. 부실 키로 데이터가 암호화되었음을 확인하는 enclave는 데이터를 암호화하는 데 사용된 키가 더 이상 키 목록에 유지 관리되지 않을 가능성을 최소화하기 위해 현재 키로 데이터를 다시 암호화해야 합니다. |
반환 값
이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
EnclaveUnsealData를 호출하는 enclave는 EnclaveSealData를 호출하여 데이터를 봉인한 enclave에서 지정한 ENCLAVE_SEALING_IDENTITY_POLICY 값에 해당하는 조건을 충족해야 합니다.
EnclaveUnsealData 는 enclave 내에서 호출되어야 하며 , ENCLAVE_TYPE_VBS enclave 형식이 있는 enclave 내에서만 지원됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winenclaveapi.h |
| 라이브러리 | Vertdll.lib |
| DLL | Vertdll.dll |