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

要解除密封之密封數據的指標。 此數據可以儲存在記憶體保護區的位址範圍或主機進程的位址空間內

[in] ProtectedBlobSize

要解除密封之密封數據的大小，以位元組為單位。

[out] DecryptedData

緩衝區的指標，其中應該放置未加密的數據。 此數據可以儲存在記憶體保護區的位址範圍內，或儲存在主機進程的位址空間內。 如果此參數為 NULL，則只會計算解密數據的大小。

[in] BufferSize

DecryptedData 參數指向的緩衝區大小，以位元組為單位。 如果 DecryptedData 為 NULL， BufferSize 必須是零。 如果 DecryptedData 不是 NULL，而且解密數據的大小大於此值，則會傳回錯誤。

[out] DecryptedDataSize

接收解密數據實際大小的變數指標，以位元組為單位。

[out, optional] SealingIdentity

緩衝區的選擇性指標，應填入密封數據之內存保護區的身分識別。 如果這個指標是 NULL，則不會傳回密封記憶體保護區的身分識別。

[out, optional] UnsealingFlags

變數的選擇性指標，可接收下列描述加密二進位大型物件的零個或多個旗標。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

呼叫 EnclaveUnsealData 的記憶體保護區必須符合與記憶體保護區所指定之內存保護區所指定 之ENCLAVE_SEALING_IDENTITY_POLICY 值，方法是呼叫 EnclaveSealData 來密封數據的準則。

EnclaveUnsealData 必須從記憶體保護區內呼叫，而且只有在記憶體保護區類型 為 ENCLAVE_TYPE_VBS 記憶體保護區的記憶體保護區內才支援。

規格需求

另請參閱

記憶體保護區函式

ENCLAVE_SEALING_IDENTITY_POLICY

EnclaveSealData

VBS 記憶體保護區中可用的 Vertdll API