InitializeEnclave-Funktion (enclaveapi.h)

Artikel
02/05/2024

Initialisiert eine Enclave, die Sie erstellt und mit Daten geladen haben.

Syntax

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

Parameter

[in] hProcess

Ein Handle für den Prozess, für den die Enclave erstellt wurde.

[in] lpAddress

Jede Adresse innerhalb der Enclave.

[in] lpEnclaveInformation

Ein Zeiger auf architekturspezifische Informationen, die zum Initialisieren der Enclave verwendet werden sollen.

Geben Sie für die Typen ENCLAVE_TYPE_SGX und ENCLAVE_TYPE_SGX2 Enclave einen Zeiger auf eine ENCLAVE_INIT_INFO_SGX-Struktur an.

Geben Sie für den ENCLAVE_TYPE_VBS Enclavetyp einen Zeiger auf eine ENCLAVE_INIT_INFO_VBS-Struktur an.

[in] dwInfoLength

Die Länge der Struktur, auf die der lpEnclaveInformation-Parameter in Bytes zeigt. Für die Enclavetypen ENCLAVE_TYPE_SGX und ENCLAVE_TYPE_SGX2 muss dieser Wert 4096 sein. Für den ENCLAVE_TYPE_VBS Enclave-Typ muss dieser Wert sein sizeof(ENCLAVE_INIT_INFO_VBS), d. h. 8 Bytes.

[in] lpEnclaveError

Ein optionaler Zeiger auf eine Variable, die einen architekturspezifischen Enclave-Fehlercode empfängt.

Für die Typen ENCLAVE_TYPE_SGX und ENCLAVE_TYPE_SGX2 Enclave enthält der lpEnclaveError-Parameter den Fehler, dass die EINIT-Anweisung generiert wird, wenn die Funktion fehlschlägt und GetLastErrorERROR_ENCLAVE_FAILURE zurückgibt.

Für den ENCLAVE_TYPE_VBS Enclave-Typ wird der lpEnclaveError-Parameter nicht verwendet.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Eine Liste der allgemeinen Fehlercodes finden Sie unter Systemfehlercodes. Die folgenden Fehlercodes gelten auch für diese Funktion.

Rückgabecode	Beschreibung
ERROR_ENCLAVE_FAILURE	Es ist ein Für die zugrunde liegende Enclave-Architektur spezifischer Fehler aufgetreten. Der Wert für den lpEnclaveError-Parameter enthält den architekturspezifischen Fehler. Für die ENCLAVE_TYPE_SGX - und ENCLAVE_TYPE_SGX2 Enclave-Typen hat die EINIT-Anweisung, die von der angegebenen ENCLAVE_INIT_INFO_SGX-Struktur angegeben wurde, einen Fehler generiert. Der Wert des lpEnclaveError-Parameters enthält den Fehler, den die Anweisung generiert hat.
ERROR_BAD_LENGTH	Der Wert des dwInfoLength-Parameters stimmte nicht mit dem erwarteten Wert überein, der auf dem für den lpEnclaveInformation-Parameter angegebenen Wert basiert.
ERROR_RETRY	Der Prozessor konnte die Enclave nicht rechtzeitig initialisieren. Versuchen Sie erneut, die Enclave zu initialisieren.

Hinweise

Verwenden Sie zum Erstellen einer Enclave die CreateEnclave-Funktion . Um Daten vor der Initialisierung in die Enclave zu laden, verwenden Sie die LoadEnclaveData-Funktion .

Windows 10 Version 1709 und höher und Windows 11: Rufen Sie DeleteEnclave auf, um die Enclave nach Ihrer Verwendung zu löschen. Sie können eine VBS-Enclave nicht löschen, indem Sie die Funktion VirtualFree oder VirtualFreeEx aufrufen. Sie können eine SGX-Enclave weiterhin löschen, indem Sie VirtualFree oder VirtualFreeEx aufrufen.

Windows 10, Version 1507, Windows 10, Version 1511, Windows 10, Version 1607 und Windows 10, Version 1703: Rufen Sie die Funktion VirtualFree oder VirtualFreeEx auf, und geben Sie die folgenden Werte an:

Die Basisadresse der Enclave für den lpAddress-Parameter .
0 für den dwSize-Parameter .
MEM_RELEASE für den dwFreeType-Parameter .

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	enclaveapi.h (winbase.h einschließen)
Bibliothek	Kernel32.lib
DLL	Api-ms-win-core-enclave-l1-1-0.dll; Kernel32.dll; KernelBase.dll