InitializeEnclave 函式 (記憶體保護區api.h)

發行項
02/03/2024

初始化您使用資料建立和載入的記憶體保護區。

語法

BOOL InitializeEnclave(
  [in] HANDLE  hProcess,
  [in] LPVOID  lpAddress,
  [in] LPCVOID lpEnclaveInformation,
  [in] DWORD   dwInfoLength,
  [in] LPDWORD lpEnclaveError
);

參數

[in] hProcess

建立記憶體保護區之進程的句柄。

[in] lpAddress

記憶體保護區內的任何位址。

[in] lpEnclaveInformation

用來初始化記憶體保護區之架構特定資訊的指標。

針對 ENCLAVE_TYPE_SGX 和 ENCLAVE_TYPE_SGX2 記憶體保護區類型，請指定 ENCLAVE_INIT_INFO_SGX 結構的指標。

針對 ENCLAVE_TYPE_VBS 記憶體保護區類型，請指定 ENCLAVE_INIT_INFO_VBS 結構的指標。

[in] dwInfoLength

lpEnclaveInformation 參數指向的結構長度，以位元組為單位。針對 ENCLAVE_TYPE_SGX 和 ENCLAVE_TYPE_SGX2 記憶體保護區類型，此值必須是4096。對於 ENCLAVE_TYPE_VBS 記憶體保護區類型，此值必須是 sizeof(ENCLAVE_INIT_INFO_VBS)，也就是8個字節。

[in] lpEnclaveError

可接收架構特定記憶體保護區錯誤碼之變數的選擇性指標。

針對 ENCLAVE_TYPE_SGX 和 ENCLAVE_TYPE_SGX2 記憶體保護區類型， lpEnclaveError 參數包含如果函式失敗而 GetLastError 傳回ERROR_ENCLAVE_FAILURE時產生的 EINIT 指令錯誤。

對於 ENCLAVE_TYPE_VBS 記憶體保護區類型，不會使用 lpEnclaveError 參數。

傳回值

如果函式成功，則傳回非零的值。如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如需常見錯誤碼的清單，請參閱系統錯誤碼。下列錯誤碼也適用於此函式。

傳回碼	Description
ERROR_ENCLAVE_FAILURE	發生基礎記憶體保護區架構特有的失敗。 lpEnclaveError 參數的值包含架構特定的錯誤。針對ENCLAVE_TYPE_SGX和ENCLAVE_TYPE_SGX2記憶體保護區類型，指定之ENCLAVE_INIT_INFO_SGX結構的EINIT指令會產生錯誤。 lpEnclaveError 參數的值包含指令產生的錯誤。
ERROR_BAD_LENGTH	dwInfoLength 參數的值不符合根據 lpEnclaveInformation 參數所指定的值所預期的值。
ERROR_RETRY	處理器無法及時初始化記憶體保護區。再次嘗試初始化記憶體保護區。

備註

若要建立記憶體保護區，請使用 CreateEnclave 函式。若要在初始化數據之前將數據載入記憶體保護區，請使用 LoadEnclaveData 函式。

Windows 10 版本 1709 和更新版本和 Windows 11：若要在完成使用記憶體保護區時刪除記憶體保護區，請呼叫 DeleteEnclave。您無法藉由呼叫 VirtualFree 或 VirtualFreeEx 函式來刪除 VBS 記憶體保護區。您仍然可以呼叫 VirtualFree 或 VirtualFreeEx 來刪除 SGX 記憶體保護區。

Windows 10 版本 1507、Windows 10 版本 1511、Windows 10、1607 版和 Windows 10 1703 版：若要在完成使用時刪除記憶體保護區，請呼叫 VirtualFree 或 VirtualFreeEx 函式並指定下列值：

lpAddress 參數記憶體保護區的基位址。
0 表示 dwSize 參數。
MEM_RELEASEdwFreeType 參數。

規格需求


最低支援的用戶端	Windows 10 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2016 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	enclaveapi.h (包含 Winbase.h)
程式庫	Kernel32.lib
DLL	Api-ms-win-core-enclave-l1-1-0.dll;Kernel32.dll;KernelBase.dll