Функция LoadEnclaveData (enclaveapi.h)

Загружает данные в неинициализированный анклав, созданный путем вызова CreateEnclave.

Синтаксис

BOOL LoadEnclaveData(
  [in]            HANDLE  hProcess,
  [in]            LPVOID  lpAddress,
  [in]            LPCVOID lpBuffer,
  [in]            SIZE_T  nSize,
  [in]            DWORD   flProtect,
  [in]            LPCVOID lpPageInformation,
  [in]            DWORD   dwInfoLength,
  [out]           PSIZE_T lpNumberOfBytesWritten,
  [out, optional] LPDWORD lpEnclaveError
);

Параметры

[in] hProcess

Дескриптор процесса, для которого был создан анклав.

[in] lpAddress

Адрес в анклаве, по которому требуется загрузить данные.

[in] lpBuffer

Указатель на данные, которые вы хотите загрузить в анклав.

[in] nSize

Размер данных, которые требуется загрузить в анклав, в байтах. Это значение должно быть целым числом, кратным размеру страницы.

[in] flProtect

Защита памяти, используемая для страниц, которые вы хотите добавить в анклав. Список значений защиты памяти см. в разделе Константы защиты памяти. Это значение не должно включать следующие константы:

• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE
• PAGE_NOACCESS

Это значение может включать константы анклава, которые описаны в следующей таблице:

[in] lpPageInformation

Указатель на сведения, описывающие страницы, которые нужно добавить в анклав. Параметр lpPageInformation не используется.

[in] dwInfoLength

Длина структуры, на которую указывает параметр lpPageInformation , в байтах. Это значение должно быть равно 0.

[out] lpNumberOfBytesWritten

Указатель на переменную, получающую количество байтов, скопированных LoadEnclaveData в анклав.

[out, optional] lpEnclaveError

Необязательный указатель на переменную, получающую код ошибки анклава, зависящий от архитектуры. Параметр lpEnclaveError не используется.

Возвращаемое значение

Если все данные успешно загружены в анклав, возвращаемое значение будет ненулевым. В противном случае возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Список распространенных кодов ошибок см. в разделе Системные коды ошибок. Для этой функции также применяются следующие коды ошибок.

Комментарии

Чтобы инициализировать анклав после загрузки данных в анклав, вызовите Метод InitializeEnclave.

LoadEnclaveData — это поддерживаемые анклавы, имеющие типы анклавов ENCLAVE_TYPE_SGX и ENCLAVE_TYPE_SGX2 .

Требования

См. также раздел

Функции анклава

CreateEnclave

InitializeEnclave

Константы защиты памяти