InitializeEnclave 함수(enclaveapi.h)

아티클
02/03/2024

데이터로 만들고 로드한 Enclave를 초기화합니다.

구문

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

매개 변수

[in] hProcess

Enclave를 만든 프로세스에 대한 핸들입니다.

[in] lpAddress

enclave 내의 모든 주소입니다.

[in] lpEnclaveInformation

Enclave를 초기화하는 데 사용할 아키텍처 관련 정보에 대한 포인터입니다.

ENCLAVE_TYPE_SGX 및 ENCLAVE_TYPE_SGX2 enclave 형식의 경우 ENCLAVE_INIT_INFO_SGX 구조체에 대한 포인터를 지정합니다.

ENCLAVE_TYPE_VBS enclave 형식의 경우 ENCLAVE_INIT_INFO_VBS 구조체에 대한 포인터를 지정합니다.

[in] dwInfoLength

lpEnclaveInformation 매개 변수가 가리키는 구조체의 길이(바이트)입니다. ENCLAVE_TYPE_SGX 및 ENCLAVE_TYPE_SGX2 enclave 형식의 경우 이 값은 4096이어야 합니다. ENCLAVE_TYPE_VBS enclave 형식의 경우 이 값은 8바이트인 이어야 합니다sizeof(ENCLAVE_INIT_INFO_VBS).

[in] lpEnclaveError

아키텍처별 Enclave 오류 코드를 수신하는 변수에 대한 선택적 포인터입니다.

ENCLAVE_TYPE_SGX 및 ENCLAVE_TYPE_SGX2 enclave 형식의 경우 lpEnclaveError 매개 변수에는 함수가 실패하고 GetLastError가 ERROR_ENCLAVE_FAILURE 반환하는 경우 생성된 EINIT 명령이 발생하는 오류가 포함됩니다.

ENCLAVE_TYPE_VBS enclave 형식의 경우 lpEnclaveError 매개 변수가 사용되지 않습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다. 함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

일반적인 오류 코드 목록은 시스템 오류 코드를 참조하세요. 이 함수에도 다음 오류 코드가 적용됩니다.

반환 코드	설명
ERROR_ENCLAVE_FAILURE	기본 Enclave 아키텍처와 관련된 오류가 발생했습니다. lpEnclaveError 매개 변수의 값에는 아키텍처별 오류가 포함됩니다. ENCLAVE_TYPE_SGX 및 ENCLAVE_TYPE_SGX2 enclave 형식의 경우 ENCLAVE_INIT_INFO_SGX 구조가 지정한 EINIT 명령으로 오류가 발생했습니다. lpEnclaveError 매개 변수의 값에는 명령이 생성한 오류가 포함됩니다.
ERROR_BAD_LENGTH	dwInfoLength 매개 변수의 값이 lpEnclaveInformation 매개 변수에 지정된 값에 따라 예상되는 값과 일치하지 않습니다.
ERROR_RETRY	프로세서는 적시에 enclave를 초기화할 수 없었습니다. enclave를 다시 초기화합니다.

설명

Enclave를 만들려면 CreateEnclave 함수를 사용합니다. 데이터를 초기화하기 전에 Enclave에 로드하려면 LoadEnclaveData 함수를 사용합니다.

Windows 10 버전 1709 이상 및 Windows 11: 사용을 완료할 때 enclave를 삭제하려면 DeleteEnclave를 호출합니다. VirtualFree 또는 VirtualFreeEx 함수를 호출하여 VBS enclave 를 삭제할 수 없습니다. VirtualFree 또는 VirtualFreeEx를 호출하여 SGX enclave를 삭제할 수 있습니다.

Windows 10 버전 1507, Windows 10, 버전 1511, Windows 10, 버전 1607 및 Windows 10 버전 1703: 사용을 완료할 때 enclave를 삭제하려면 VirtualFree 또는 VirtualFreeEx 함수를 호출하고 다음 값을 지정합니다.

lpAddress 매개 변수에 대한 enclave의 기본 주소입니다.
dwSize 매개 변수의 경우 0입니다.
dwFreeType 매개 변수에 대한 MEM_RELEASE.

요구 사항


지원되는 최소 클라이언트	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