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

Статья
02/03/2024

Загружает данные в неинициализированный анклав, созданный путем вызова 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

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

Константа	Описание
PAGE_ENCLAVE_THREAD_CONTROL	Страница содержит структуру управления потоками (TCS).
PAGE_ENCLAVE_UNVALIDATED	Указанное содержимое страницы исключается из измерения с помощью инструкции EEXTEND модели программирования расширений Intel Software Guard.

[in] lpPageInformation

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

[in] dwInfoLength

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

[out] lpNumberOfBytesWritten

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

[out, optional] lpEnclaveError

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

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

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

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

Код возврата	Описание
ERROR_BAD_LENGTH	Значение параметра dwInfoLength не совпадало с ожидаемым значением на основе значения, указанного для параметра lpPageInformation .

Требования


Минимальная версия клиента	Windows 10 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2016 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	enclaveapi.h (включая Winbase.h)
Библиотека	onecore.lib
DLL	Api-ms-win-core-enclave-l1-1-0.dll; kernel32.dll; KernelBase.dll

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

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

CreateEnclave

InitializeEnclave

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